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译 者 


ASPNET 是 Web 开发 的 主要 工具 之 一 ， 构 建 在 NET Framework 之 上 。 日 微软 
推出 这 种 技术 ， 人 至 今 已 经 有 将 近 二 十 年 的 时 间 。 为 了 紧 跟 技术 和 应 用 环境 的 最 新 发 
展 ， 微 软 在 ASPNET 的 基础 上 开发 出 了 轻 量 级 、 跨 平台 的 ASPNET Core。 

ASPNET Core 是 币 软 新 的 宠儿 ， 其 开源 性 、 蜂 平台 性 和 轻 量 级 特性 意味 看 它 会 
受到 开发 社区 的 欢迎 , 并且 之 前 由 于 种 种 原因 没有 选择 ASPNET 的 公司 和 个 人 , 可 
能 从 此 选择 ASPNET Core。 无 论 从 哪个 角 上 大 看 ，ASPNET Core 很 快 将 会 流行 起 来 ， 
并 且 预 计 在 未 来 很 长 一 段 时 期 内 会 是 业界 的 领头 羊 。 因 此 ， 从 现在 开始 了 解 
ASPNET Core， 不 仅 能 接触 到 Web 开 友 的 前 治 技术 ， 满 足 开 发 人 员 的 好 奇 心 ， 也 有 
助 于 将 来 需要 使 用 ASPNET Core 进行 开发 时 迅速 上 手 。 

选择 阅读 本 书 ， 读 者 必 将 受益 菲 浅 。 本 书 由 点 及 和 面 ， 将 ASPNET Core 开发 的 
理念 和 技术 进行 具体 分 析 ， 寻 根 究 夸 ， 力 求 深入 ， 而 后 从 生态 系统 的 角度 ， 讲 解 如 
何 部 署 自己 的 ASPNET Core 应 用 程序 。 

本 书 作 者 对 .NET 开发 有 看 丰富 的 经 验 和 深刻 的 认识 , 相信 读者 在 阅读 本 书 的 过 
程 中 ， 经 常会 有 醋 可 灌顶 的 感觉 。 例 如 ， 作 者 开宗明义 ， 一 开始 就 解释 了 为 什么 在 
ASPNET 技术 已 经 十 分 成 熟 的 情况 下 ， 微 软 还 要 开发 ASPNET Core。 理 解 这 个 原 
因 后 ， 读 者 就 对 ASPNET Core 的 理念 、 技 术 需 求 和 应 用 场景 有 了 总 体 认 识 。 这 种 
认识 就 像 指 路 明灯 ， 不 仅 使 读者 在 学 习 ASPNET Core 的 具体 技术 和 实际 应 用 时 不 
会 走 入 歧途 ， 而 且 使 理解 ASPNET Core 的 技术 和 具体 应 用 变 得 容易 许多 。 

之 后 本 书 通过 一 个 基本 的 ASPNET Core 项 目 ， 帮 助 读 者 认识 ASPNET Core 的 
结构 、 特 点 和 基本 应 用 。 形 成 了 总 体 认识 ， 束 能 够 更 有 目的 地 学 习 ASPNET Core。 
于 是 ， 在 表面 内 容 的 基础 上 ， 作 者 分 成 几 个 部 分 讲解 ASPNET Core 的 方方面面 。 
首先 讲解 ASPNET Core 的 应 用 模型 ， 细 致 探讨 了 MVC 模型 、 控 制 融 和 视 网 部 分 ， 
并 对 Razor 语法 进行 了 人 介绍。 然后， 讲解 了 一 些 普 过 适用 的 问题 ， 如 设计 上 的 一 些 
考虑 、 应 用 安全 、 如 何 访问 应 用 的 数据 等 。Web 应 用 不 只 涉及 后 人 台 ， 所 以 作者 还 讲 
解 了 前 端的 一 些 问题 ， 包 括 如 何 设计 Web API， 以 及 与 客户 端 有 关 的 一 些 问题 。 最 
后 ， 作 者 从 实用 的 角度 出 发 ， 介 绍 了 ASPNET Core 的 生态 系统 ， 如 何 部 署 自己 的 
ASPNET Core 应 用 ， 并 分 析 了 如 何 将 现 有 的 应 用 迁移 到 ASPNET Core。 

在 本 书 的 翻译 过 程 中 ， 同 事 崔 会 虽 给 予 了 很 大 的 帮助 ， 另 外 刘 治 国 、 王 惠 民 、 
畦 江华 、 曹 莫 云 、 张 海 暇 和 李 明 明 也 耐心 为 我 解答 了 一 些 有 困惑 的 地 方 ， 帮 助 我 保 
证 技术 翻译 的 准确 性 ， 在 此 一 并 致谢 ! 


作 者 商 介 


Dino Esposito 是 BaxEnergy 的 一 名 数字 策略 师 , 迄今 已 经 撰写 了 超过 20 本 图 书 
和 1000 篇 文章 。 他 的 编程 生涯 已 有 25 年 。 大 家 都 公认 ， 他 撰写 的 图 书 和 文章 促进 
了 全 世界 数 干 名 .NET 开发 人 员 和 架构 师 的 职业 发 展 .Dino 的 编程 生涯 始 于 1992 年 ， 
当时 他 是 一 名 C 开发 人 员 。 他 见证 了 .NET 的 问世 、Silverlight 的 兴衰 ， 以 及 各 种 架 
构 模 式 的 起 起 伏 伏 , 他 现在 很 期 每 人 工 智 能 2.0 和 区 块 链 ,他 创作 了 The Sabbatical 
Break 一 一 这 是 一 部 戏剧 风格 的 作品 ， 讲 述 了 游历 未 被 污染 的 想象 空间 ， 将 软件 、 文 
学 、 和 科学、 体育、 技术 和 亏 术 融合 在 一 起 。 可 以 通过 http://youbiquitous.net 联系 他 ， 
也 可 以 访问 : 

http://twitter.com/despos 

http://instaeram.com/desposofficial 

http://facebook.com/desposofficial 
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ASPNET Core 发 展 历程 的 茶 些 方面 让 我 想起 了 15 年 前 ASPNET 刚 问 世 的 
时 候 。1999 年 秋天 ， 当 时 还 很 年 轻 的 Scott Guthrie 现在 担任 Microsoft 的 副 总 
裁 一 一 在 伦敦 问 一 小 群 Web 开发 人 员 展 示 了 一 个 被 称 为 ASP+ 的 新 东西 。 当 时 还 
是 Active Server Pages 居于 统治 地 位 的 时 代 ，ASP+ 试 图 引入 一 种 新 语法 ， 将 
VBScript 代码 放 回 服务 器 ， 并 用 一 种 编译 语言 来 表达 这 种 语法 。ASP+ 是 一 项 重大 
的 成 束 。 

Scott 进行 展示 时 ， 公众 还 不 知道 有 .NET， 它 要 到 第 二 年 夏天 才 会 正式 公布 。 
Scott 在 一 个 独立 有 的 运行 环境 中 进行 演示 (演示 内 容 包 括 一 个 令 人 惊叹 的 Web 
Service 示例 )， 这 个 运行 时 环境 基于 一 个 能 够 监听 端口 80 的 日 定义 工作 进程 (一 
个 控制 台 应 用 程序 )。 最 早 的 演示 使 用 了 普通 的 Visual Basic 和 C++ 代码 ， 以 及 
Win32 API。 很 快 ，ASP+ 被 吸收 到 了 新 的 .NET Framework 中 ， 并 最 终 赔 变 为 
ASPNET., 

ASPNET Core 在 一 开始 被 展示 时 ， 同 样 作 为 一 个 新 的 独立 框架 ， 这 是 一 个 从 头 
编写 的 框架 ， 将 Microsoft 的 Web 堆栈 的 可 扩展 性 和 性 能 提升 到 了 新 高 度 。 但 在 这 
个 过 程 中 ，ASPNET Core 的 开发 团队 看 到 了 一 个 谤 人 的 机 会 来 让 ASPNET Core 框 
架 在 多 个 平台 上 可 用 。 为 实现 这 个 目标 ， 必 须 使 NET Framework 的 一 个 子 集 在 目标 
平台 上 可 用 ， 这 总 味 看 必须 创建 一 个 新 的 .NET Framework。 最 终 ， 一 个 新 的 .NET 
Framework 被 开发 出 来 了 。 

在 很 长 时 间 内 ，ASPNET Core 是 一 个 移动 的 目标 ,而 移动 这 个 目标 的 机 制 没有 
人 清楚 ， 并 且 没 有 被 及 时 、 有 效 地 沟通 。 大 约 20 年 前 ， 我们 还 没有 如 今 这 种 社交 媒 
体 带 来 的 即时 分 享 的 态度 。 而 且 ， 虽 然 ASP+ 很 可 能 也 是 一 个 移动 的 目标 ， 但 是 
Microsof 以 外 的 人 们 (其 至 Microsoft 内 没有 直接 参与 ASP+ 项 目的 人 们 ) 并 不 知道 这 

虽然 ASPNET 和 ASPNET Core 的 及 展 过 程 在 关键 方 面 可 能 看 上 去 是 相同 的 ， 
但 是 它们 的 发 展 环境 有 很 大 区 别 。ASPNET 之 前 的 Web 是 新 生 阶 段 的 Web， 可 扩 
展 的 服务 器 疹 技 术 有 限 ， 而 且 可 扩展 性 并 不 像 今天 这 样 是 一 个 严峻 的 问题 。 同 时 ， 
有 大 量 应 用 程序 需要 针对 Web 重 写 , 只 是 在 等 待 由 可 徘 的 供应 商 提 供 的 一 个 可 徘 的 
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如 今 , 即使 不 使 用 ASPNET Core, 也 仍然 有 许多 框架 可 供 使 用 ,但 是 , ASPNET 
Core 并 不 只 是 前 站 技术 ;: 它 也 是 后 问 技 术 、Web API 以 及 要 独立 部 蜀 或 者 部 蜀 到 
Service Fabric 的 小 型 简洁 的 Web( 容 器 化 ) 整 体式 应 用 程序 。ASPNET Core 还 可 以 用 
在 多 个 便 件 /软件 平台 上 。 

很 难说 在 近期 其 至 目前 , ASPNET Core 会 不 会 成 为 每 个 公司 和 团队 必须 使 用 的 
技术 。 但 可 以 肯定 ，ASPNET Core 是 ASPNET 开发 人 员 需 要 了 解 的 一 种 技术 ， 是 
在 多 种 平台 上 进行 Web 开发 时 可 供 使 用 的 为 一 种 全 栈 解 决 方案 。 


本 书面 向 的 读者 对 得 


完全 的 新 手 (全 少 是 对 Web 开发 没有 一 点 了 解 的 新 手 ) 个 适合 阅读 本 书 。 本 书 针 
对 的 是 ASPNET 开发 人 员 ， 尤 其 是 具有 MVC 背景 的 ASPNET 开发 人 员 。 同 时 ， 
本 书 适 合 有 丰富 开发 经 验 的 Web 开发 人 员 ， 特 别 是 具有 MVC 开发 背景 但 是 新 接触 
ASPNET 的 Web 开发 人 人员。 虽然 ASPNET Core 是 一 种 全 新 的 框架 ， 但 是 它 与 
ASPNET MVC 有 许多 共同 点 ， 与 Web Forms 也 有 少量 共同 点 。 

如 果 读 者 使 用 Microsoft 技术 或 者 计划 使 用 Microsoft 技术 , 那么 对 于 全 栈 开发 ， 
ASPNET Core 提供 了 一 个 出 色 的 选择 ， 包 括 与 Azure 云 紧 密 结合 起 来 。 


本 书 的 假定 


本 书 假定 读者 对 Microsoft 堆栈 (其 他 平台 也 可 以 ) 上 的 Web 开发 有 基本 了 解 , 最 
好 有 成 熟 的 理解 。 


本 书 不 适合 的 读者 对 象 


如 果 读 者 是 Web 编程 的 新 手 ， 从 来 没有 听 说 过 ASPNET, 想 要 寻找 一 本 ASPNET 
Core 的 分 步骤 指南 ， 那 么 本 书 可 能 不 是 一 个 理想 选择 。 


本 书 结构 


本 书 分 为 5 个 部 分 。 

e 第 I 部 分 概述 ASPNET Core 的 基础 知识 ， 并 介绍 hello-world 应 用 程序 。 
e 第 工 部 分 关注 MVC 应 用 程序 模型 ， 并 介绍 其 核心 组 成 ， 如 控制 器 和 视图 。 
e 第 I 部 分 介绍 一 些 公共 的 开 友 问题 ， 如 映 份 验证 、 配 置 和 数据 访问 。 
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e 第 IV 部 分 介绍 用 于 构建 可 用 的 、 有 效 的 表示 层 的 拉 术 和 其 他 框架 。 
e 第 V 部 分 介绍 运行 时 管 违 、 部 普 和 迁移 策略 。 


系统 需求 


要 完成 本 书 的 练习 ， 需 要 配备 下 面 列 出 的 硬件 和 软件 : 

e Windows 7 或 更 高 版 本 ，macOS 10.12 或 更 高 版 本 。 

e 或 者 ， 可 使 用 众多 Linux 发 行 版 中 的 一 种 ， 请 参考 https://docs.microsoft. 
com/en-us/dotnet/core/lmux-prerequisites.。 

e ”Visual Studio 2015 或 更 高 版 本 的 任意 版本 : Visual Studio Code。 

e ”Internet 连接 ， 以 下 载 软件 或 者 章 世 示例 。 


代码 示例 下 载 


本 书 中 的 所 有 代码 ， 可 在 https://aka.ms/ ASPNetCore/downloads 上 找到 ， 也 可 
扫描 封底 二 维 码 获取 。 


勘误 、 更 新 和 图 书 支 持 
我 们 已 经 尽 最 大 努力 来 确保 本 书 及 其 配套 内 容 的 准确 性 。 在 以 下 网 址 ， 可 以 得 
阅 本 书 的 更 新 列表 ， 其 中 列举 了 提交 的 勤 误 及 对 应 的 更 正 : 
https://aka.ms/ASPNetCore/errata 


如 果 读 者 发 现 了 列表 中 没有 列 出 的 错误 ， 请 在 该 页面 上 把 针 误 提交 给 我 们 。 

如 果 需 要 人质 外 的 文 持 ， 请 给 Microsoft Press Book Support 发 送 邮 件 ， 地 址 为 
mspinput(Wmicrosott.com. 

请 注意 ， 上 和 耐 列 出 的 地 址 不 提供 对 Microsoft 的 软件 和 便 件 产品 的 文 持 。 要 想 获 
得 关于 Microsoft 的 软件 和 硬件 的 帮助 ， 请 访问 http:/supportmicrosoft.com 。 


保持 联系 


让 我 们 保持 对 话 ! 在 Twitter 上 可 以 联系 到 我 们 : http://twitter.com/MicrosoftPress。 
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第 1 部 分 
新 ASP.NET 一 宛 


欢迎 来 到 ASPNET Core 的 世界 。 

目 Microsoft 开发 出 ASPNET 和 .NET Framework， 己 有 超过 15 年 的 时 
由 。 在 此 期 间 ，Web 开发 已 经 发 生 了 天 番地 和 窗 的 变化 。 开 发 人 员 在 这 段 时 期 
学 到 了 很 多 ， 客 户 则 想 让 开发 人 员 以 新 的 方式 把 截然 不 同 的 解决 方案 交付 到 
新 的 设备 上 。ASPNET Core 反映 了 这 些 变化 ,而 且 考 虑 到 了 未 来 有 可 能 发 生 的 
变化 。 本 书 第 I 部 分 依托 背景 介绍 ASPNET Core， 将 帮助 读者 快速 入 门 。 

第 1 章 解 释 了 ASPNET Core 出 现 的 原因 、 读 者 (特别 是 ASPNET MVC 
开发 人 员 ) 可 能 感到 熟悉 的 地 方 ， 以 及 截然 不 同 的 地 方 。 我 们 将 在 人 简洁 的 、 模 
块 化 的 、 开 源 的、 器 平台 的 .NET Core Framework 环境 中 探索 ASPNET Core， 
并 了 解 ASPNET Core 如 何 为 极 简 Web 服务 和 完整 网 站 提供 更 好 的 支持 。 另 外 ， 
第 1 草 还 会 何 单 介绍 ASPNET Core 的 命令 行 接 口 (Command-Line Interface, CLT) 
Hm Ts 

在 第 2 章 ， 我 们 将 快速 创建 目 己 的 第 一 个 应 用 程序 。 一 些 东 西 似乎 从 不 
会 改变 ， 如 第 一 个 开发 的 应 用 程序 是 Hello World。 我 们 将 延续 这 个 大 家 熟知 
的 传统 。 但 是 即便 如 此 ， 读者 也 会 了 解 到 ASPNET Core 令 人 集 讶 的 极 简 性 ， 
以 及 是 什么 在 文 持 看 这 种 极 简 风格 。 


为 什么 又 开 妈 一 个 ASP.NET 


如 果 我 们 希望 事情 保持 原状 ， 就 到 了 必须 发 生 改 变 的 时 候 了 。 
一 一 朱 塞 佩 ， 托 马 西 ， 迪 。 兰 佩 杜 萨 , 《 鹏 》 


时 间 大 概要 回 到 1999 年 夏天 。 当 时 , 为 Windows 操作 系统 编写 软件 需要 具备 C/C++ 
技能 和 一 些 庞大 的 库 ， 如 Microsoft Foundation Classes(MFC) 和 ActiveX Template 
Library(AIIL)， 和 帮助 简化 开 有 友 。 组 件 对 象 模型 (Component Object Model，COMD) 正 在 
成 为 Windows 系统 上 运行 的 所 有 应 用 程序 的 根本 基础 。 所 有 应 用 程序 功能 (包括 数 
据 访 问 ) 都 将 被 重新 设计 为 从 合 且 能 够 感知 COM。 但 是 ， 选 择 什 么 编程 语言 和 开 友 
工具 仍然 是 重要 的 钴 虑 因素 ， 如 下 数据 访问 或 复杂 的 用 户 界 和 面 在 要 开发 的 Windows 应 
用 程序 中 必 不 可 少 ， 就 尤为 如 此 。 如 果 选 择 了 Visual Basic， 那 么 数据 库 访 问 是 很 容 
易 实现 的 ， 也 能 够 快速 实现 美观 的 用 户 界面 ， 但 缺点 是 不 能 使 用 函数 指针 ， 也 不 能 
访问 (至 少 不 能 很 容易 、 很 可 靠 地 访问 )Windows SDK 的 所 有 函数 。 另 一 方面 ， 如 果 
选择 了 CC 或 Ct+， 束 没有 局 层 的 数据 访问 工具 可 用 ,而 且 相 比 Visual Basic, 构建 六 
单 或 工具 栏 吏 困难 多 了 。 

对 软件 从 业 人 员 来 说 ， 当 时 的 环境 并 不 轻松 ， 但 是 我 们 最 终 都 设法 找到 了 适合 
目 己 的 领地 ， 并 能 够 运营 壮大 目 己 的 业务 。 然 而 ， 突 然 间 ，.NET 出 现 了 ， 一 切 都 变 
得 更 好 了 。 


第 | 部 分 新 ASPNET 一 览 


1.1 .NET 平台 现状 


.NET 平台 于 2000 年 夏天 公布 , 一 年 后 进入 第 二 个 beta 阶段 。2002 年 初 ， NET 
1.0 发 布 ， 不 过 从 软件 行业 的 角度 看 ， 那 已 经 是 几 个 地 质 时 代 之 前 了 。 


1.1.1 .NET 平台 的 亮点 


.NET 平台 由 一 个 类 框架 和 一 个 名 为 公共 语言 运行 时 (Common Language Runtime， 
CLR) 的 虚拟 机 组 成 。CLR 在 本 质 上 是 一 个 执行 环境 ， 负 责 执行 在 概念 上 用 类 似 于 
Java 字 攻 但 的 中 间 语 言 (ntermediate Language， 卫 ) 编 瑟 的 代 公 。CLR 为 运行 代码 提 
供 了 各 种 服务 ， 例 如 内 存 管理 和 垃圾 回收 、 异 常 处 理 、 安 全 、 版 本 管理 、 调 试 和 分 
析 。 最 重要 的 是 ，CLR 能 以 一 种 路 语言 的 方式 提供 这 些 服 务 。 

在 CLR 之 上 是 语言 编译 器 和 “托管 语言 >。 托 管 语言 即 存在 对 应 编译 器 的 一 种 
普通 的 编程 语言 ; 编译 器 能 生成 开 代码 供 CLR 执行 。 所 有 .NET 编译 器 都 会 生成 工 
代码 ， 但 是 十 代码 不 能 直接 在 Windows 操作 系统 上 运行 。 因 而 ， 另 一 个 工具 被 开 
上 友 出 来 : 实时 Gust-in-time) 编 详 问 。 这 种 编 详 项 将 工 代码 转换 成 能 够 御 接 在 特定 便 
件 / 软 件 平台 上 运行 的 二 进 制 代码 。 


1.1.2 .NET Framework 


在 当时 ，.NET 最 令 我 感到 震撼 的 是 其 在 同一 个 项 目 中 混合 不 同 编程 语言 的 能 
力 。 例 如， 可 以 用 Visual Basic 创建 一 个 库 ， 然 后 在 使 用 其 他 任何 托管 语言 编号 的 代 
码 中 调用 这 个 库 。 万 外 ，.NET 还 提供 了 一 个 新 的 、 极 为 强大 的 语言 ， 也 驶 是 如 今 普 
遍 使 用 的 C# 语 言 ， 它 在 Java 语言 的 灰 灼 上 浴 火 重生 。 

忌 的 来 看 ， 对 开发 人 员 来 说 ， 最 大 的 变化 是 能 用 类 访问 抵 层 Windows SDK 的 
大 部 分 功能 。 这 些 类 构成 了 基 类 库 (Base Class Library，BCL)， 是 任何 .NET 应 用 程 
序 都 能 够 使 用 的 公共 基础 代码 。BCL 是 与 CLR 紧密 集成 在 一 起 的 可 重用 类 型 的 集 
合 ， 包 括 基 本 关 型 、LINQ， 以 及 对 第 见 操作 有 玫 助 的 关 和 头 型 ， 如 IO、 日 期 、 集 
合 和 诊断 。 

BCL 得 到 了 额外 的 一 组 针对 性 很 强 的 库 的 补充 ， 如 用 于 数据 库 访 问 的 ADO.NET、 
用 于 果 耐 Windows 应 用 程序 的 Windows Forms、 用 于 Web 应 用 的 ASPNET, 以 及 XML 
等 。 这 些 额 外 的 库 偿 渐 壮 大 ， 吸 收 了 一 些 庞 大 的 框架 ， 例 如 Windows Presentation 
Foundation (WPF)、Windows Communication Foundation(WCEF) 和 Entity Framework(EF). 

BCL 与 这 些 籁 外 的 框 染 一 起 构成 了 NET Framework。 


第 1 章 为 什么 又 开发 一 个 ASPNET 


1.1.3 ASP.NET Framework 


1999 年 秋天 ，Microsoft 揭 开 了 一 个 新 Web 框架 的 面纱 ， 计 划 用 其 取代 Active 
Server Pages(ASP)。 在 最 初 的 公开 演示 中 ， 这 个 新 框架 个 称 为 ASP+， 基 于 其 目 己 的 
C/C++ 引擎 ， 后 来 被 纳入 .NET 平台 ， 成 为 如 今 的 ASPNET。 

ASPNET 框架 包含 Internet Information ServerQ1IS) 的 一 个 扩展 ,能够 捕捉 传 入 的 
HTTP 请 求 ， 并 通过 ASPNET 的 运行 时 环境 处 理 它们 。 在 运行 时 框 染 中 ， 通 过 找到 
能 够 处 理 该 请 求 的 特定 组 件 ， 然 后 为 浏览 左 准 备 一 个 HTTP 啊 应 包 ， 来 解析 请 求 。 
运行 时 环境 的 结构 就 像 一 个 管道 : 请求 进入 这 个 管道 ， 经 历 不 同 的 阶段 ， 直 到 被 完 
整 处 理 ， 之 后 其 啊 应 被 写 回 到 输出 流 中 。 

与 竞争 对 手 不 同 的 是 ，ASPNET 提供 一 个 有 状态 的 、 基 于 事件 的 编程 模型 ， 人 多 
许 隐 舍 的 上 下 文 从 一 个 请 求 传递 到 男 一 个 请 求 。 困 面 应 用 程序 的 开发 人 员 很 熟悉 这 
种 模型 ,而 这 种 模型 也 将 Web 编程 世界 问 诸 多 只 有 有 限 HTML 和 JavaScript 技能 (其 
至 完全 不 具备 这 些 技 能 ) 的 开发 人 员 打 开 。 由 于 最 初 的 ASPNET 在 HTTP 和 HTML 
之 上 添加 了 厚 厚 的 抽象 层 , 因此 和 它 吸 引 了 众多 Visual Basic、Delphi、C/C++ 其 全 Java 
程序 员 。 


1. Web Forms 模型 


ASPNET 运行 时 环境 在 最 初 设 计时 有 两 个 主要 目标 : 

e 第 一 个 目标 是 提供 一 个 编程 模型 ， 尽 可 能 使 开发 人 员 不 必 接 触 HIML 和 
JavaScript。Web Forms 模型 受到 经 典 的 客户 机 /服务 器 请 求 的 影响 ， 应 用 效 
果 极 好 , 创建 出 了 一 个 既 包含 免费 服务 器 组 件 ， 又 包含 商用 服务 器 组 件 的 生 
态 系统 ， 提 供 了 越 来 越 高 级 的 功能 ， 如 智能 数据 网 格 、 输 入 表单 、 回 导 、 日 

e 第 二 个 目标 是 尽量 将 ASPNET 和 IIS 混合 到 一 起 。ASPNET 被 设想 为 IS 
的 左 膀 右 辟 , 而 不 只 是 一 个 插件 , 其 运行 时 环境 将 成 为 HS 结构 的 一 部 分 。2008 
年 发 布 的 IS7 是 一 个 里 程 碑 ,在 IIS 7 及 更 高 版 本 的 集成 管道 (Integrated Pipeline) 
工作 模式 下 ，IIS 和 ASP.NET 共 圣 相同 的 省 志 。 请 求 在 进入 IIS 时 采取 的 路 
径 与 在 ASP.NET 中 采取 的 路 径 相同 。ASP.NET 代码 只 是 负责 处 理 请 求 ， 以 
及 按照 自己 的 需要 拦截 和 预 处 理 任何 请 求 。 

大 约 在 2009 年 ，Web Forms 编程 模型 得 到 ASPNET MVC 的 补 序 。ASPNET 
MVC 的 出 现 受 到 与 ASPNET 最 初 设想 的 目标 完全 不 同 的 一 种 原则 的 局 发 。 在 Web 
Forms 模型 中 ，ASPNET 由 和 面 通过 服务 右 控 件 生成 日 己 的 HTML， 这 也 是 ASPNET 
能 够 取得 成 功 并 被 快速 接受 的 主要 原因 。 这 些 服务 器 控件 是 黑 盒 组 件 (以 声明 的 方式 
或 者 编程 的 方式 配置 )， 为 浏览 器 生 成 HTML 和 JavaScript。 但 是 ， 开 发 人 员 对 于 生 
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成 的 HTML 只 有 程度 有 限 的 控制 ， 而 人 们 的 需求 在 随 看 时 间 改 变 。 
2. ASP.NET MVC 模型 


ASPNET MVC 是 全 新 设计 的 ， 上 自在 更 加 接近 HTTP 协议 工作 ; ASPNET MVC 
没有 淮 试 隐 疾 HITP 的 任何 功能 ,而 是 要 求 开 发 人 员 熟 悉 HITP 请 求 和 啊 应 的 机 制 。 
理想 情况 下 ， 使 用 ASPNET MVC 的 开发 人 员 应 该 具备 JavaScript 和 CSS 技能 。 
ASPNET MVC 是 在 新 的 足 领 域 需求 (例如 关注 点 隐 离 、 模 块 化 和 可 测试 性 ) 的 推动 
下 ， 对 编程 模型 进行 重新 设计 的 结果 。 

ASPNET MVC 做 出 了 一 个 也 许 并 不 容易 的 决定 : 不 建立 目 己 的 运行 时 环境 ， 
而 是 作为 现 有 ASPNET 运行 时 的 一 个 插件。 这 既是 一 个 好 消息 ， 也 是 一 个 坏 消息 。 
说 是 好 消息 ， 是 因为 可 以 选择 通过 Web Forms 模型 或 者 ASPNET MVC 模型 来 处 理 
传 入 的 请 求 ， 这 样 一 来 就 很 容易 在 一 开始 建立 一 个 Web Form 应 用 程序 ， 然 后 逐渐 
将 其 演化 成 一 个 ASPNET MVC 应 用 程序 。 说 是 坏 消息 ， 是 因为 这 样 一 来 就 不 能 解 
决 ASPNET 在 结构 上 的 (按照 现代 需求 来 说 ) 缺 点 。 例 如 ，ASPNET MVC 团队 尽力 
做 到 了 能 够 模拟 整个 HTTP 上 下 文 ， 却 无 法 在 框架 中 建立 完整 的 、 规 范 的 依赖 注入 
基础 结构 。 

对 于 处 理 必 须 返 回 HTML 内 容 的 Web 请 求 ,ASPNET MVC 编程 模型 是 最 灵活 、 
最 容易 理解 的 方式 。 但 是， 从 菏 个 时 间 开 始 , 伴 随 看 移动 空间 的 爆炸 式 发 展 , HTML 
不 再 是 HTTP 请 求 唯 一 可 能 的 输出 。 


1.1.4 Web API 框架 


移动 设备 出 现 后 ， 能 够 请 求 Web 端点 ， 回 任意 类 型 的 客户 端 提 供 任意 类 型 的 内 
容 ， 如 JSON、XML、 图 片 和 PDF。 任何 能 够 发 出 HTTP 请 求 的 一 段 代 但 都 是 Web 
端点 的 潜在 客户 端 。 而 且 ， 某 些 解 决 方案 的 可 扩展 性 变 得 至 关 重 要 。 

在 ASPNET 的 空间 中 , 并 没有 多 少 余 地 来 扩展 其 基础 结构 , 进而 适应 新 的 场景 : 
高 度 可 扩展 性 、 云 和 平台 无 关 性 。Web API 框架 的 出 现 旨 在 提供 一 个 临时 解决 方案 ， 
应 对 瘦 服 务 器 的 高 需求 ， 这 种 服务 器 能 够 提供 RESTful 接口 ， 并 与 任意 HITP 客户 
端 进行 对 话 ， 而 不 作 任何 假定 或 限制 。Web API 框架 是 另外 一 组 类 ， 用 于 创建 只 知 
道 完 整 的 HITP 语法 和 语义 的 HITP 端 点 .Web API 框 架 提供 的 编程 接口 与 ASPNET 
MVC 几乎 相同 ,包括 控制 占 、 路 由 和 模型 绑 定 , 但 是 在 一 个 全 新 的 运行 时 环境 中 运 
行 它们 。 

在 ASPNET Web API 中 ， 让 创建 的 Web 框架 与 Web 服务 器 解除 耦合 的 观念 开 
始 生根 ， 导 致 了 Open Web Interface for NET(OWIN) 标 准 被 定义 出 来 。 OWIN 是 一 套 
规范 ， 设 定 了 Web 服务 器 与 Web 应 用 程序 的 互 操作 规则 。 随 者 OWIN 的 问世 ， 
ASPNET 最 初 的 第 二 个 目标 ( 即 Web 宿主 与 Web 应 用 程序 的 强 耦 合 ) 成 为 往事 。 
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任何 遵守 OWIN 标准 的 应 用 程序 都 能 够 成 为 Web API 的 潜在 答 主 ， 但 是 Web 
API 要 想 做 到 有 用 ， 残 必须 托管 到 ITS 中 ， 这 就 需要 有 一 个 ASPNET 应 用 程序 。 在 
ASPNET 应 用 程序 (无 论 是 Web Forms 还 是 MVO) 中 使 用 Web API 会 导致 应 用 程序 
使 用 的 内 存量 增加 ， 因 为 使 用 了 两 个 运行 时 环境 。 


1.1.5 “对 极 简 Web 服务 的 需求 


近年 来 ， 软 件 行 业 出 现 了 另 一 个 重要 的 变化 ， 开 始 需 要 极 简 Web 服务 ， 也 就 是 
包围 一 段 业 务 逻 辑 的 一 个 薄 注 的 Web 服务 器 层 。 

极 简 Web 服务 器 是 一 个 HITP 端点 ， 客 己 决 可 调用 这 个 端点 来 获取 基本 的 、 主 
要 基于 文本 的 内 容 。 这样 的 Web 服务 器 不 需要 运行 复杂 的 、 定 制 的 管道 ， 而 是 只 需 
要 接受 HITP 请 求 ， 根 据 情况 进行 处 理 ， 然 后 返回 一 个 HITP 啊 应 。 这 个 过 程 不 应 
该 有 开销 ， 或 者 应 该 具有 上 下 文 要 求 的 开销 。 对 客户 端 编程 模型 (如 Angular) 的 运用 
进一步 增加 了 对 这 种 Web 服务 的 需求 。 

ASPNET 及 其 所 有 运行 时 环境 都 不 是 针对 类似 的 场景 议 计 的 。 虽 然 ASPNET 
运行 时 ( 既 支 持 Web Forms 应 用 , 也 支持 MVC 应 用 ) 在 一 定 程度 上 可 定制 (禁用 会 话 、 
渝 出 绥 存 其 全 身份 验证 ), 但 是 并 没有 达到 如 今 的 一 些 业 务 场 景 所 要 求 的 粒度 和 控制 
级 别 。 例 如 ，ASPNET 几乎 无 法 转变 为 有 效 的 静态 文件 服务 右 。 


1.2 15 年 过 去 后 的 .NET 


对 于 任何 软件 来 说 ，15 年 都 不 是 一 个 很 短 的 时 间 ，.NET Framework 也 不 例外 。 
ASPNET 是 在 20 世纪 90 年 代 后 期 设计 出 来 的 ， 而 Web 的 变化 非常 迅速 。 大 约 在 
2014 年 ，ASPNET 团队 开始 计划 一 个 新 的 ASPNET， 并 按照 OWIN 规范 ， 设 计 了 
一 个 全 新 的 运行 时 环境 。 

该 团队 的 主要 目的 是 移 除 对 旧 有 的 ASPNET 运行 时 system.web 程序 集 是 
其 象征 的 依赖 。 不 过 ， 该 团队 还 有 一 个 关键 目标 : 使 开 友 人 员 能 够 完全 控制 管道 ， 
从 而 既 能 够 构建 极 何 Web 服务 ， 叉 能 够 构建 完整 的 网 站 。 在 这 个 过 程 中 ,该 团队 面 
I 临 看 一 个 难题 : 确保 吞吐 量 ， 并 在 保证 成 本 较 低 的 前 提 下 通过 云 平 台 有 效 地 提供 任 
意 解 决 方案 ， 使 应 用 的 内 存 占用 显著 减少 。 不 止 如 此 ， 当 时 的 .NET Framework 还 必 
须 接 受 特 殊 处 理 ， 以 实现 减 重 。 

新 的 ASPNET 的 指导 原则 可 归结 如 下 : 

e 使 ASP.NET 婚 能 够 访问 完整 的 现 有 .NET Framewotk， 义 能 够 访问 其 精简 的 

版 本 ， 这 种 版 本 去 除了 所 有 很 少 使 用 的 、 用 途 也 不 大 的 依赖 。 

e 使 新 的 ASP.NET 环境 与 牡 主 Web 服务 器 解 精 。 
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然而 ， 当 实现 了 这 个 计划 后 ， 又 出 现 了 其 他 许多 问题 和 机 遇 。 机 遇 如 此 诱 人 ， 
让 人 不 能 日 白 错过 。 


1.2.1 更 简洁 的 .NET Framework 


新 的 ASPNET 的 设计 伴随 看 一 个 新 的 .NET Framework, 后 者 最 终 补 命名 为 .NET 
Core Framework。 可 以 把 这 个 新 的 框架 视 为 原来 的 .NET Framework 的 一 个 子 集 ， 它 
被 专门 设计 成 更 加 细 粒 上 展 、 更 加 精 人 条， 更 重要 的 是 , 被 设计 为 能 够 文 持 跨 平 台 使 用 。 
这 个 设计 目标 通过 两 种 方式 实现 : 移 除 一 些 功能 并 重 与 其 他 功能 ， 以 提高 在 茶 些 情 
况 下 的 有 效 性 ， 补 偿 对 所 移 除 功 能 的 依赖 。 

.NET Core Framework 主要 被 设计 为 用 于 ASPNET 应 用 程序 。 这 个 因素 最 终 引 
导 着 在 .NET Core Framework 中 包含 哪些 库 和 斑 弃 哪些 库 。.NET Core Framework 为 
执行 应 用 程序 提供 了 一 个 新 的 运行 时 ， 称 为 CoreCLR。CoreCLR 的 布局 和 架构 与 目 
前 的 .NET CLR 相同 , 负责 加 载 十 代码, 编译 成 机 右 代 人 码 ， 以 及 回收 垃圾 。CoreCLR 
不 文 持 目前 的 CLR 的 某 些 功 能 , 例如 应 用 程序 域 和 代码 访问 安全 ,这 些 功 能 被 证 明 
并 非 是 必要 的 ， 或 者 是 专门 针对 Windows 平台 的 ， 所 以 难以 移植 到 其 他 平台 。 不 止 
如 此 ，.NET Core Framework 的 类 库 用 包 的 形式 提供 ， 而 包 的 粒度 很 小 ， 比 目前 
的 .NET Framework 小 得 多 。 

NET Core 平台 是 完全 开源 的 。 表 1-1 给 出 了 相关 存储 库 的 链接 。 


表 1-1 .NET Core 源 代 码 的 Github 链接 


平台 链接 


CoreCLR CLR 及 相关 工具 http://aithub.conydotnet/coreclr 
CoreFX .NET Core Framework http://github.conydotnet/corefx 
和 何 二 之， 完整 的 .NET Framework 与 .NET Core Framework 之 间 的 区 别 可 归结 如 下 : 


e .NET Core Framework 哆 加 精简 ， 模 块 化 程度 更 局 。 
e .NET Core Framework( 及 相关 工具 ) 是 开源 的 。 
e .NET Core Framework 只 能 用 来 编写 ASP.NET 和 控制 台 应 用 程序 。 
e .NET Core Framework 可 与 应 用 程序 一 同 部 羞 ， 而 完整 的 NET Framework 只 
能 安装 到 目标 机 器 上 ， 由 所 有 应 用 程序 共 圣 。 可 以 看 到 ， 这 一 点 为 版 本 害 理 
市 来 了 很 大 的 问题 。 
去 掉 了 平台 依赖 性 以 后 ， 就 能 够 修改 新 的 、 更 加 精简 的 .NET Framework， 使 其 
能 够 在 其 他 操作 系统 上 工作 。 这 是 .NET Core Framework 与 现 有 的 .NET Framework 
的 又 一 大 区 别 。.NET Core Framework 可 用 于 编 与 跨 平 人 台 的 应 用 程序 , 让 它们 也 能 运 
行 在 Linux 和 Mac 操作 系统 上 。 
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一 NETCore2.0 发 布 后 ， 完 整 的 NET Framework 和 .NET Core Framework 之 间 的 
功能 差异 正在 缩小 ， 因 为 Core Framework 中 已 经 移植 了 更 多 的 类 和 名 称 空间 (如 
System.Drawing 和 数据 表 类 )。 但 是 ,并 不 能 认为 .NET Core Framework 是 完整 的 NET 
Framework 的 复制 品 。.NET Core Framework 是 从 头 开 始 重 新 设计 的 一 个 新 框架 ， 看 
上 去 与 完整 的 NET Framework 很 类 似 ， 但 是 能 够 跨 平台 工作 .。 


1.2.2 将 ASPNET 与 宿主 解 耦 


为 了 使 Web 应 用 程序 模型 既 能 够 用 于 编写 极 简 Web 服务 ， 又 能 够 用 于 编写 
完整 的 网 站 , 将 ASPNET 与 IIS 解 耘 被 证 明 是 必要 的 一 步 。OWIN 的 理念 (参见 
http://owin.org) 是 : 

e 将 Web 服务 器 的 功能 与 Web 应 用 程序 的 功能 隔离 开 。 

e 政 励 为 .NET Web 开发 设计 出 更 简单 的 模块 ， 当 这 些 模 块 结合 起 来 时 ， 能 4 

实现 真实 网 站 的 强大 力量 。 

图 1-1 显示 了 OWIN 的 整体 架构 。 


图 1-1 开放 Web 接口 架构 


在 基于 OWIN 的 架构 中 ， 和 宿主 Web 服务 器 不 再 必须 是 IIS。 而 且 ， 簿 主 接口 可 
用 控制 台 应 用 程序 或 者 Windows 服务 实现 。 在 满足 了 这 些 限 制 后 ， 采 用 OWIN 开 
放 接 口 的 Web 应 用 程序 模型 的 真正 威力 就 会 展现 : 同一 个 应 用 程序 可 以 在 任何 符合 
OWIN 的 Web 服务 器 上 托管 ， 系 统 平台 是 什么 并 不 重要 。 

HTTP 协议 是 平台 无 关 的 ， 所 以 当 构 建 出 一 个 新 的 .NET Framework 版 本 ， 使 其 
不 再 罕 密 依赖 特定 的 半 台 (如 Windows) 时 ， 构 建 一 个 能 够 路 平 台 工 作 的 Web 应 用 程 
友 模 型 就 成 了 一 个 可 行 的 、 很 有 吸引 力 的 项 目 。 


站 | 
站 i 


当 IS 在 2008 年 开始 支持 集成 管道 模式 时 ，Microsoft 对 Web 的 观念 与 如 今 全 然 
不 同 。 在 某 种 程度 上 ， 环 境 也 不 同 了 。 按 照 集成 管道 的 观念 ，IIS 和 ASPNET 需要 密 
切合 作 ， 看 起 来 就 像 一 个 统一 的 引擎 。 为 新 的 ASPNET 构建 的 模型 推翻 了 集成 管道 
的 观念 ， 认 为 ASPNET 是 一 个 独立 的 环境 ， 可 以 在 任何 Web 服务 器 上 托管 。 这 种 模 
型 认为 ， 在 某 些 情况 下 ， 这 种 独立 的 环境 甚至 在 直接 呈现 给 外 界 时 也 能 够 工作 。 
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1.2.3 新 的 ASPNET Core 


ASPNET Core 是 一 个 新 的 框架 ， 用 于 构建 多 种 基于 Internet 的 应 用 程序 ， 主 要 
是 (但 不 限于 )Web 应 用 程序 。 事 实 上 ， 可 以 把 特殊 的 Web 应 用 程序 看 成 内 置 IoT 的 
服务 器 和 和 面 癌 Web 的 服务 ， 例 如 移动 应 用 程序 的 后 台 。 

在 编写 ASPNET Core 应 用 程序 时 ， 可 使 其 针对 .NET Core Framework， 也 可 以 
使 其 针对 完整 的 .NET Framework。ASPNET Core 被 设计 为 路 平台 的 ,使 开发 人 员 能 
够 创建 运行 在 Windows、Mac 和 Linux 上 的 应 用 程序 。ASPNET Core 包含 一 个 内 置 
的 Web 服务 器 和 一 个 运行 应 用 程序 代码 的 运行 时 环境 。 应 用 程序 代码 是 用 稍 作 调整 
的 ASPNET MVC 框架 编写 的 ， 并 依赖 于 一 组 系统 模块 。 这 些 系统 模块 被 设计 为 极 
小 的 模块 ， ire itn ! 要 最 小 开销 就 能 运行 的 应 用 程序 。 图 1-2 
显示 了 ASPNET Core 的 整体 架 


HTTP 
ee 
EY 


图 1-2 ASPNET Core 的 整体 架构 


;二 忌 : 
并 不 rie Web 服务 器 (如 IIS 或 Apache), 因 为 内 置 的 Web 服 务 器 (Kestrel) 
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能 够 被 直接 公开 给 外 界 。 是否 需 要 一 个 独立 的 Web 服务 器 主要 取决 于 Kestrel 能 否 
满足 需要 。 


新 的 ASPNET 依赖 于 .NET Core SDK 的 工具 来 构建 和 运行 应 用 程序 。 下 一 市 将 
详细 介绍 .NET SDK 和 命令 行 工具 。 第 14 音 将 详细 介绍 ASPNET Core 运行 时 。 
1.3 .NET Core 的 命令 行 工 具 

在 :NET Core 中 ， 所 有 的 基本 开发 工具 ( 即 用 于 构建 、 测 试 、 运 行 和 发 布 应 用 程 
序 的 工具 ) 也 作为 命令 行 应 用 程序 提供 。 这 些 应 用 程序 统称 为 NET Core 命令 行 接口 
(CILD。 


1.3.1 安装 CLI 工具 


在 能 够 开发 和 部 署 .NET Core 应 用 程序 的 所 有 平台 上 都 可 以 使 用 CLI 工具 。CLI 
工具 通常 提供 了 针对 具体 平台 定制 的 安装 包 ， 例 如 Linux 上 的 RPM 或 DEB 包 ， 或 
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者 Windows 上 的 MSI 包 。 运行 安装 程序 后 ，CLI 工具 将 安全 地 存储 到 磁盘 上 一 个 可 全 
局 访问 的 位 置 。 图 1-3 显示 了 一 台 Windows 计算 机 上 CLI 工具 的 存储 文件 夹 。 
-个 > ThisPpC > O5(C) » Program Files » dotnet > 


> 寺 上 Quick access 
六 Dropbox 


:i DneDrive 


ww MW This PC shared 


衣 Desktop 

》 局 Documents 

> 如 Downloads 

> Wh Music 
居 Pictures LICENSE.txt ThirdPartyNotices. 
国 Videos txt 

>》 站 :| 

» a Data 全) 


图 1-3 己 安 状 的 CLI 工具 


注意 ， 可 以 同时 运行 多 个 版 本 的 CLI 工具 。 当 安装 多 个 版 本 的 时 候 ， 默 认 情 况 
下 运行 的 是 最 新 版 本 。 


1.3.2 ” dotnet 驱动 程序 工具 


CLI 一 般 被 称 为 一 组 工具 ， 但 实际 上 ， 它 是 由 一 个 宿主 工具 ( 称 为 驱动 程序 ) 运 
行 的 一 组 命令 。 这 个 答 主 工具 就 是 dotnet.exe( 参 见 图 1-3)。 命 令 行 指令 的 格式 如 下 
所 示 : 

dotnet [host-options|] [command]|] [argumentsj [common-opt1Lons | 


[command] 占 位 和 从 代表 将 在 驱动 程序 工具 中 执行 的 命令 , 而 [arguments] 代 表 传 递 
给 该 命令 的 参数 。 稍 后 将 介绍 特 主 选项 和 公共 选项 。 
当 和 安装 了 CLI 的 多 个 版 本 ， 但 是 不 想 运 行 最 新 的 版 本 时 ， 可 以 在 应 用 程序 所 在 
的 文件 夹 中 创建 一 个 globaljson 文件 ， 在 其 中 至 少 添加 下 面 的 内 容 。 
{ 
"sdk™: 1 
"Version™: "2.0.0" 


} 
} 


version 属性 的 值 决定 了 使 用 哪个 版 本 的 CLI 工具 。 
;于 局 
CLI 工具 的 版 本 不 同 于 应 用 程 友 使 用 的 .NET Core 运行 时 的 版 本 .运行 时 的 版 本 


是 在 项 目 文件 中 指定 的 ， 也 可 以 在 使 用 的 IDE 界面 内 进行 编辑 。 如 果 想 手动 编辑 这 
个 项 目 文件 ， 那 么 只 需要 编辑 .csproj XML 文件 ， 修 改 TargetFramework 元 素 的 值 。 
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这 个 值 的 名 称 就 代表 了 版 本 (如 netcoreapp2.0)。 
1. 答 主 选项 


在 dotnet 工具 的 命令 po 答 主 选项 代表 的 是 dotnet 工具 的 配置 。 先 传递 了 条 
主 选项 之 后 ， 才 会 传递 命令 。 征 主 选项 文 持 3 个 值 ， 分 别 用 于 获得 关于 CLI 工具 和 
运行 时 环境 的 常规 信息 、 区 得 CLI 的 版 本 号 ， 以 及 局 用 诊断 (参见 表 1-2)。 


表 1-2 CLI 的 宿主 选项 


二 | 摘 述 
-d 或 --diagnostics 尼 用 诊断 输出 
--info 显示 运行 时 环境 和 .NET CLI 的 信息 
--VeIS10D 显示 .NET CLI 的 版 本 号 


济 
J 
a 
去 
DS 
汪 


CLI 选项 是 所 有 命令 共有 的 选项 ,例如 获得 帮助 和 局 用 详细 输出 。 


表 1-3 CLI 的 公共 选项 


平台 描述 
-V 或 --verbose 司 用 详细 输出 
h 或 --help 显示 关于 如 何 使 用 dotnet 工具 的 第 规 帮 助 


1.3.3 ”dotnet 的 预定 义 命令 


堵 认 情况 下 ， 安 状 CLI 工具 后 , 束 可 以 使 用 表 1-4 中 列 出 的 命令 。 注意 , 表 1-4 
尽量 按照 真实 使 用 这 些 命 令 的 顺序 介绍 它们 。 


表 1-4 音 用 的 CLI 命令 
命令 描述 

new 使 用 东 个 可 用 的 模板 创建 一 个 新 的 NET Core 应 用 程序 。 默 认 的 
模板 包括 控制 台 应 用 程序 ， 以 及 ASPNET MVC 应 用 程序 、 测 试 
项 目 和 类 库 。 还 有 和 铬 外 的 选项 可 指定 目标 语言 和 项 目的 名 称 

restore 恢复 项 目的 所 有 依赖 。 从 项 目 文 件 读 取 依赖 后 ， 将 其 恢复 为 从 配 
置 好 的 源 使 用 的 NuGet 包 

build 构建 项 目 及 其 全 部 依赖 .应 在 项 目 文件 中 指定 编译 器 的 参数 (如 构 
建 的 是 库 还 是 应 用 程序 ) 
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角 令 描述 

IUD 编译 源 代 人 码 ( 如 有 必要 )， 生 成 可 执行 文件 并 执行 。 执 行 此 命令 前 ， 
必须 先 执 行 build 命令 

test 使 用 配置 好 的 测试 运行 程序 在 项 目 内 执行 单元 测试 。 单 元 测试 是 
依赖 于 特定 早 元 测试 框 染 及 其 运行 程 厅 的 类 库 

publish 编译 应 用 程序 (如 有 必要 )， 从 项 目 文件 中 读 取 依赖 列表 ， 然 后 将 
得 到 的 一 组 文件 友 布 到 一 个 输出 目录 

pack 使 用 项 目的 二 进 制 文件 创建 一 个 NuGet 包 

migrate 将 原来 的 基于 project.json 的 项 目 迁 移 为 基于 msbuild 的 项 目 

clean 清理 项 目的 输出 文件 来 


要 详细 了 解 如 何 调 用 上 述 命令 ， 可 在 命令 行 中 输入 下 面 的 命令 : 
dotnet <command> 一 -helPp 


通过 在 项 目 中 引用 可 移植 的 控制 台 应 用 程序 或 者 将 可 执行 文件 复制 到 PATH 环 
境 变 量 关 联 看 的 攻 个 目录 中 (可 全 局 使 用 )， 可 添加 更 多 命令 。 


1.4 小结 


NET 平台 问世 已 经 超过 15 年 了 ， 在 这 段 时 间 内 ， 它 吸引 J 了 大 量 投入 ， 变 得 非 
第 流行 。 然 而 ， 世 界 总 在 不断 地 变化 ， 朱 竹 佩 。 托 马 西 ， 迪 。… 兰 佩 杜 陕 的 小 说 《能 》 
中 有 一 句 话 说 得 再 准确 人 不过: 如果 我 们 希望 事情 保持 原状 ， 束 到 了 必须 发 生 改 变 的 
时 修了 。 因 而 , 原来 的 .NET 平台 一 一 那个 围绕 看 一 个 庞大 的 类 库 和 一 些 应 用 程序 模 
型 (ASPNET、Windows Forms 和 和 WPF) 设计 出 来 的 .NET 平台 一 一 如 今 也 正在 经 历 看 
深刻 的 重新 设计 。 之 所 以 说 “正在 经 历 ?， 是 因为 重新 设计 的 工作 在 2014 年 开始 ， 
到 版 本 2.0 实现 第 一 个 里 程 碑 ， 但 是 在 未 来 仍 将 继续 进行 下 去 。 

从 业务 上 来 说 , 你 可 能 想 也 可 能 还 不 想 现 在 就 拥抱 这 个 新 的 平台 , 但 是 我 相信 ， 
在 儿 年 内 ， 新 的 平台 将 成 为 首选 的 平台 和 要 迁移 到 的 平台 。 新 平台 的 亮点 在 于 高 度 
模块 化 和 路 平台 的 本 质 。 基 于 .NET Core 的 任何 代码 将 能 够 运行 在 Linux、Mac 或 
Windows 平台 上 ， 只 是 需要 不 同 的 运行 时 。 由 于 非常 侧重 跨 平 台 的 开发 ， 因 此 操作 
对 应 平台 的 所 有 核心 工具 (和 生成、 运行、 测试 和 发 布 ) 都 作为 命令 行 工 具 提 供 ， 在 这 
些 命令 行 工具 的 基础 上 可 构建 IDE。.NET Core 的 命令 行 接口 被 称 为 CLI 工具 。 

在 第 2 章 ， 我 们 将 开始 介绍 本 书 的 核心 主题 : ASPNET 和 Web 开 友 。 
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第 一 个 ASP.NET Core 项 目 


所 有 动物 生来 平等 ， 但 有 些 动物 比 其 他 动物 更 平等 。 
一 一 乔治 ， 奥 威 尔 , 《动物 上 庄园 》 


ASPNET Core 是 基于 .NET Core 平台 的 一 个 面 问 Web 的 应 用 程序 模型 。 虽然 名 
称 中 市 有 熟悉 的 ASPNET 字样 ,但 是 ASPNET Core 与 前 一 个 ASPNET 版 本 并 不 相 
同 。 最 重要 的 是 ，ASPNET Core 有 一 个 全 新 的 运行 时 环境 ， 只 文 持 一 种 应 用 程序 模 
型 : ASPNET MVC。 这 意味 着 这 个 新 的 Web 框架 与 Web Forms 全 然 不 同 ， 甚 至 与 
Web API 也 不 完全 相同 。ASPNET Core 是 全 新 的 框架 ， 只 有 ASPNET MVC 编程 模 
型 (控制 器 、 视 图 和 路 由 ) 中 的 一 部 分 代码 和 技能 能 够 在 这 个 框架 中 重用 。 


重要 / 


在 本 章 和 本 书 剩余 内 容 中 ,我们 将 提 到 非 .NET Core ASPNET( 包 括 Web Forms、 
ASPNET MVC 和 Web APD 的 特点 和 实现 细节 ,并 将 之 与 ASPNET Core 的 特点 进行 
比较 。 为 避免 混 消 ， 我 们 使 用 术语 “经 典 ASPNET” 指 代 ASPNET Core 出 现 之 前 
的 ASPNET 中 可 用 的 任意 应 用 程序 模 型 


2.1 ASP.NET Core 项 目的 分 析 


有 几 种 不 同 的 方式 可 创建 一 个 新 的 ASPNET Core 项 目 。 首先 ， 可 以 使 用 Visual 
Studio 中 提供 的 某 个 标准 项 目 模板 。 其 次 ， 可 在 CLI 工具 中 使 用 New 命令 。 如 果 使 
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用 的 是 另 一 种 IDE,， 如 JetBrains”s Rider， 那 么 有 另 一 组 ASPNET 项 目 模 板 可 用 。 最 
后 ， 如 果 只 是 想 生 成 文件 并 放 到 目 己 完全 控制 的 一 个 项 目下 ， 那 么 Yeoman 中 的 
ASPNET 生成 占 可 能 是 最 好 的 选择 。 

Yeoman 是 一 个 语言 无 关 的 项 目 生 成 器 ， 如 果 配 置 正 确 ， 可 以 生成 所 有 必要 的 
文件 来 构成 一 个 Web 应 用 程序 (包括 ASPNET Core 应 用 程序 ) 的 基本 上 骨架。 更 多 信 


县 请 访问 http://yeoman.io/learning。 


注意 : 

使 用 Visual Studio、Rider、 CLI 工具 和 Yeoman 得 到 的 项 目 文件 稍 有 区 别 . Visual 
Studio 提供 两 个 选项 : 基本 项 目 ， 以 及 包含 成 员 系 统 和 Bootstrap 的 完整 项 目 。CLI 
工具 的 New 命令 也 会 生成 一 个 丰富 的 ASPNET 项 目 。 使 用 Rider 生成 的 默认 
ASPNET Core 应 用 程序 介 于 一 个 空 项 目 和 一 个 完全 配置 但 没有 应 用 程序 逻辑 的 项 
目 之 间 。Yeoman 可 能 是 最 灵活 的 生成 器 ， 提 供 了 一 些 选项 供 选择 使 用 。 


2.1.1 项 目 结构 


从 图 2-1 可 以 看 到 ，Visual Studio 提供 了 预定 义 模板 ， 用 于 创建 经 典 的 非 .NET 
Core Web 应 用 (基于 完整 的 NET Framework)， 以 及 ASPNET Core 应 用 。 图 中 选中 
的 选项 一 一 ASPNET Core Web Application(.NET Core)， 创 建 一 个 针对 .NET Core 框 
名 的 ASPNET Core 应 用 程序 。 

ep ; 
b Recent .NET Framework 4.6.2 | sort by | Default -| 中 Search Installed Templates (Ctr+E) PA- 
es ~ @] AspNETrweb Application (NET Frameworl Visual C# Type: Visual C# 


a Templates Project templates for creating ASP.NET 


4 Visual C# DD ASP.NET Core Web Application (NET Core) Visual C# Core applications for Windows, Linux and 
) MacOs using .NET Core. 


Windows Classic Desktop 
Web > ASP.NET Core Web Application (NET Framewaork) Visual C# 


:NET Core 
.NET Standard 
Cloud 
Extensibility 


图 2-1 在 Visual Studio 中 创建 一 个 新 的 ASPNET Core 项 日 


问 导 的 下 一 步 要 求 指 定 为 第 一 次 运行 应 用 程序 生成 的 代码 量 。 我 认为 ， 全 少 对 
于 学 习 目 的 ， 最 好 的 方法 是 先生 成 一 个 基本 的 但 是 能 够 工作 的 项 目 。 在 这 个 方面 ， 
Visual Studio 的 Empty 选项 十 分 理想 ， 如 图 2-2 所 示 。 

确认 选择 的 选项 后 ，Visual Studio 会 创建 一 些 文 件 并 配置 新 项 目 。 接 下 来 ， 我 
们 将 检查 这 些 文件 ， 并 把 它们 构建 成 一 个 可 执行 文件 。 
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New ASP.NET Core Web Application - WebApplication1 


NET Core v |EASPNET Core 20 “| |earn more 


An empty project template for creating an ASP.NET 
四 加 | 国 | LA Core application. This template does not have any 


content in tt. 
Web API Web Web Angular 
Application Application 
(Model-View- 
Controller) 


Learn more 


suthentication No Authentication 


| _ | Enable Docker Support 


OS: Windows 


Requires Docker for Windows 
Docker support can also be enabled later Learn more 


图 2-2 ”选择 一 个 宇 项 目 
1. 空 项 目 速 览 


对 于 具有 不 同 开发 背景 的 读者 , 选择 Empty 选项 生成 的 解决 方案 的 内 容 可 能 引 
发 不 同 的 有 反应。 例如, ASPNET 开发 人 员 会 注意 到 , wwwroot 项 目 文件 夹 有 些 反 币 ， 
并 且 解 决 方案 中 缺少 global.asax( 一 个 对 过 去 的 ASPNET 来 说 非常 午 要 的 文件 )。 男 
一 个 对 过 去 的 ASPNET 配置 来 说 非常 重要 的 文件 (web.config 文件 ) 仍 然 出 现在 解决 
方案 中 ， 但 其 内 容 却 发 生 了 较 大 变化 (如 图 2-3 所 示 )。 


各 名 -| -5 内 | 一 
Search solution Explorer (Ctrl+) 局 


四] Solution "WebApplication1' (1 project) 
4 |] WebApplication1 
CP Connected Services 
4 a Dependencies 
b i NuGet 
b> EE] SDK 
4 £ Properties 
J launchSettings.json 
时 Wwwroot 
> Program.cs 
b c# Startup.cs 


se Solution... | Team Expl... Server Ex... 


图 2-3 ” 衬 项 目的 Solution Explorer 的 内 容 
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如 图 2-3 所 示 ， 解 决 方案 中 包含 两 个 新 文件 :Startup.cs 和 Program.cs。 如 果 之 
前 用 过 基于 OWIN 的 框架 ， 如 Web API 或 ASPNET SignalR， 那 么 看 到 Startup.cs 
也 许 不 会 感到 特别 奇怪 。 但 是 , 在 Web 应 用 程序 中 看 到 Program.cs 可 能 会 让 你 大 吃 
一 惊 。 在 Web 应 用 程序 中 有 一 个 控制 台 程 序 文 件 ? 这 怎么 可 能 ? 

原因 在 于 托管 和 运行 ASPNET Core 应 用 程序 的 新 运行 时 基础 结构 。 接 下 来 会 
更 详细 地 介绍 一 个 基本 ASPNET Core 项 目的 构成 。 


2. Wwwroot 文件 夹 的 用 途 


残 静态 文件 而 言 ASPNET Core 运行 时 会 区 分 内 容 根 文件 来 和 Web 根 文件 夹 。 

内 容 根 文件 夹 一 般 是 项 目 当 前 的 目录 ， 在 生产 中 束 是 部 草 的 根 文件 夹 。 它 代表 
代码 需要 执行 的 所 有 文件 搜索 和 访问 的 基础 路 径 。 与 乙 相 对 ，Web 根 文件 夹 是 应 用 
程序 可 能 提供 给 Web 客户 痛 的 所 有 静态 文件 的 基础 路 径 。 一 般 来 说 ，Web 根 文件 夹 
是 内 容 根 文件 夹 的 子 文件 来， 被 命名 为 wwwroot。 

有 趣 的 是 ， 在 生产 机 问 上 必须 创建 Web 根 文 件 夹 ， 但 是 这 个 文件 夹 对 于 请 求 静 
态 文 件 的 客户 疾 浏 览 器 来 说 是 完全 透明 的 。 换 名 话说 ， 如 果 在 wwwroot 下 有 一 个 images 
子 文 件 夹 ， 其 中 有 一 个 名 为 bannerjpg 的 文件 ， 那 么 获取 这 个 横幅 的 有 效 URL 为 : 

/images/banner .jpg 

但 是 ， 真 实 的 图 卢 文 件 必 须 放 到 服务 器 上 的 wwwroot 文件 夹 中 ; 否则 ， 将 无 法 
检索 到 该 文件 。 通 过 编写 代 公 ， 能 够 在 Program.cs 文件 中 修改 两 个 根 文件 夹 的 位 置 
( 稍 后 将 详细 介绍 这 一 点 )。 


注意 : 
在 经 典 的 ASPNET 中 ， 内 容 根 文件 夹 和 Web 根 文件 夹 并 不 存在 一 个 清晰 的 、 
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系统 级 的 区 别 。 其 中 内 容 根 文件 夹 被 自动 定义 为 安装 应 用 程序 的 根 文件 夹 。 但 是 ， 
有 一 个 明确 定义 的 Web 根 文件 夹 是 一 个 很 好 的 做 法 (被 大 部 分 团队 采用 )， 如 今 已 成 
为 ASPNET Core 的 一 个 系统 特性 。 个 人 而 言 ， 我 喜欢 把 我 的 Web 根 文件 夹 称 为 
Content， 但 是 我 发 现 很 多 人 喜欢 把 它 称 为 Assets。 无 论 如 何 ， 在 经 典 的 ASPNET 
中 ，Web 根 文件 夹 的 定义 是 虚拟 的 ， 在 指向 该 文件 夹 内 包含 的 一 个 静态 文件 的 URL 
中 必须 包含 该 文件 夹 。 

3. Program 文件 的 用 途 

虽然 听 起 来 可 能 很 奇怪 ， 但 是 ASPNET Core 应 用 程序 只 不 过 就 是 第 1 章 介 绍 
过 的 dotnet 驱动 程序 工具 局 动 的 一 个 控制 台 应 用 程序 。 这 个 不 可 缺少 的 控制 台 应 用 
程序 的 源 代码 就 包含 在 Program.cs 文件 中 。 图 2-4 很 好 地 演示 了 这 个 控制 台 应 用 程 
序 的 角色 。 
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配置 的 ASPNET Core HTTP 模 块 使 用 
dotnet.exe 来 局 动 控 市 侣 


主 ASPNET 控 台 应 用 程 
HTTP 时 时 pe ry 


服务 天 


(如 IIS) 


图 2-4 ASPNET Core 应 用 程序 工作 原理 的 俯视 图 


Web 服务 器 (如 IS) 通 过 一 个 配置 的 端口 与 完全 解 条 的 可 执行 文件 通信 ， 并 将 
传 入 的 请 求 转发 给 控制 台 应 用 程序 。 这 个 控制 台 应 用 程序 由 一 个 必要 的 HITP 模 
块 从 IIS 进程 空间 生成 ,该 HTTP 模块 使 JIS 能够 支持 ASPNET Core。 要 将 ASPNET 
Core 应 用 程序 托管 到 其 他 Web 服务 器 (如 Apache 或 NGINX) 上 ， 必 须 有 类 似 的 扩 
展 模块 


J 
站 站 
i i 


值得 注意 的 是 ， 图 2-4 给 出 的 ASPNET Core 架构 与 最 初 的 架构 ( 即 2003 年 将 
ASPNET 1.x 与 IIS 连接 起 来 的 架构 ) 有 类 似 之 处 。 当 时 ，ASPNET 有 自己 的 工作 进 
程 ， 通 过 命名 管道 与 IIS 通信 。 后 来 ，ASPNET 工作 进程 的 任务 被 内 置 的 IIS 工作 
进程 (w3wp.exe) 接 过 ， 从 而 有 了 应 用 程序 池 的 概念 。 在 ASPNET Core 中 ， 两 个 独立 
的 、 无 关 的 、 完 全 解 耦 的 可 执行 文件 进行 通信 ,但 是 ASPNET 可 执行 文件 并 不 是 一 
个 多 租户 工作 进程 ， 而 只 是 托管 一 个 基本 的 异步 服务 器 来 处 理 传 入 请 求 的 应 用 程序 
的 一 个 实例 。 


在 内 部 ， 控 制 台 应 用 程序 基于 Program.cs 文件 中 的 如 下 几 行 代码 : 


public static void Main(string[|] args) 
{ 
Var host = new WebHostBuilder() 
.UseKestrell() 
.UseContentRoot (Directory.GetCurrentDirectory()) 
.UseIIlISIntegration () 
.Usestartup<Sstartup> () 
-Build({); 
host.Run(}).; 
} 


ASPNET Core 应 用 程序 需要 在 一 个 特 主 中 执行 。 牡 主 负责 该 应 i hr 
生命 周期 管理 。WebHostBuilder 类 人 负责 构建 一 个 有 效 的 ASPNET Core 答 主 的 完 
配置 实例 。 表 2-1 徐 要 解释 了 上 面 代码 段 中 调用 的 方法 所 执行 的 任务 。 
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表 2-1 ASP.NET Core 宿主 的 扩展 方法 


方法 效果 
UseKestrel 告诉 循 主要 使 用 的 内 置 Web 服务 占 。 内 置 的 Web 服务 项 负责 在 特 主 上 
下 文中 接受 和 处 理 HTTP 请 求 。Kestrel 是 默认 的 跨 平 台 ASPNET 内 置 
Web 服务 上 需 
UseContentRoot 告诉 笨 主 内 容 根 文件 夹 的 位 置 
UseIISIntegration 告诉 箱 主 使 用 IS 作为 反 癌 代理, IS 将 从 公共 Intemet 抓 取 请 求 ,然后 传 


递 给 内 置 服务 器 (注意 ， 对 于 ASPNET Core 应 用 程序 ， 出 于 安全 和 流量 
原因 ， 可 能 推荐 使 用 一 个 反 向 代理 ， 但 是 纯粹 从 功能 的 角度 来 看 ， 反 站 
代理 并 不 是 必须 要 有 的 ) 

UseStartup<I> 告诉 箱 主 包 合 应 用 程序 补 始 化 设置 的 从 型 

Build 构建 ASPNET Core 宿主 类 型 的 一 个 实例 


WebHostBuilder 类 有 许多 扩展 方法 ， 可 用 来 进一步 定制 行为 。 

而 且 ，ASPNET Core 2.0 为 构建 Web 箱 主 实例 提供 了 一 种 更 加 简单 的 方式 。 通 
过 使 用 “默认 的 ”生成 器 ， 一 次 调用 就 能 够 返回 新 创建 的 Web 牡 主 实 例 。 下 面 滨 示 
本 如 何 编写 Program.cs 文件 。 


public class Program 


{ 
public static Vola Main(string[|] args) 
{ 
BuildWebHostInstance (args) .Run (); 
} 
public static IWebHost BuildWwebHostInstance (string|[||] args) => 
WebHost .CreateDefaultBuilder (args) 
.UseStartup<Startup> () 
-Buildi()}); 
} 


静态 方法 CreateDefaultBuilder 蔡 我 们 完成 所 有 工作 ， 如 瀛 加 Kestrel、IIS 配置 、 
办 容 根 文件 夹 以 及 其 他 选项 (如 日 志 提供 程序 和 配置 数据 )， 而 在 ASPNET Core 1.1 
之 前 ， 只 能 在 局 动 类 中 添加 它们 。 要 理解 CreateDefaultBuilder 方法 完成 的 工作 ， 最 好 
的 方法 是 丛 看 其 源 代 人 码 : http://github.com/aspnet/MetaPackages/blob/dev/src/Microsoft. 
AspNetCore/WebHost.cs#L.130。 


4. 局 动 文件 的 用 途 


Startup.cs 文件 包含 的 类 用 来 配置 请 求 管道 , 而 请 求 管 道 则 处 理发 送 给 应 用 程序 
的 所 有 请 求 。 该 类 至 少 包含 两 个 方法 ， 供 宿主 在 初始 化 应 用 程序 的 时 候 回调 。 第 一 
个 方法 是 ConfigureServices， 用 于 添加 应 用 程序 需要 使 用 的 依赖 注入 机 制服 务 。 在 
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局 动 类 中 ，ConfigureServices 方法 是 可 选 的 ,但 是 在 大 部 分 现实 场景 中 ， 都 必须 使 
用 该 方法 。 
第 二 个 方法 是 Configure。 顾 名 思 义 ， 访 方法 用 于 配置 新 面 请 求 的 服务 。 例 如 ， 

如 果 在 ConfigureServices 方法 中 声明 了 要 使 用 ASPNET MVC 服务 ， 那 么 在 
Configure 方法 中 可 以 调用 IApplicationBuilder 参数 的 UseMvc 方法 ， 指 定 想 要 处 理 
的 有 效 路 由 的 列表 。Configure 方法 是 一 个 必须 具有 的 方法 。 注 意 ， 局 动 类 不 需要 实 
现任 何 接口 或 者 继承 任何 基 类 。 事 实 上 ，Configure 和 ConfigureServices 方法 都 是 通 
过 反射 来 上 友 现 并 调用 的 。 


__ si 
注意 : 


也 许 听 起 来 很 奇怪 ， 但 是 ASPNET Core 允许 使 用 控制 器 、 视 图 和 路 由 来 编写 
Web 应 用 程序 ， 而 不 一 定 是 ASPNET MVC 应 用 程序 。 因 此 ， 如 果 想 编写 规范 的 
ASPNETMVC， 就 必须 先 请 求 MVC 特定 的 服务 。 


在 某 种 程度 上 ， 局 动 类 中 所 执行 的 操作 与 经 典 ASPNET 中 的 global.asax 的 
Application Start 方法 和 web.config 文件 的 菜 些 片段 中 编写 的 操作 十 分 相似 。 

注意 , 局 动 类 的 名 称 并 不 是 不 可 改变 的 。Startup 这 个 名 称 是 一 个 很 合理 的 选择 ， 
但 是 我 们 可 以 根据 喜好 加 以 修改 。 显 然 ， 如 有 条 重合 名 了 局 动 兴 ， 那 么 在 调用 
UseStartup<T> 时 必须 传 入 正确 的 类 型 。 另 外 ， 注 意 UseStartup 打 - 展 方法 提供 了 ee 
额外 的 重 载 ， 供 指定 局 动 突 。 例 如 ， 可 以 将 局 动 类 的 名 称 作 为 其 -程序 集 字 符 串 或 一 
个 Type 对 象 传 入 ， 如 下 所 示 : 


// Using a non-conventional and nostalgic name 
// for the startup class (GlobalAsax) 
fF 
Var host = new WebHostBuilder () 
.UseKestrell) 
-UseCcontentRoot (Directory.GetCurrentDirectory()) 
.UseIlIlSIntegration () 
.UseSstartup<GlobalAsax> () 
.Bulld(); 


下 } 
} | 
下 jf 
站 fF 
f i 
下 


如 前 所 述 ， 本章 只 是 触及 了 ASPNET 运行 时 和 宿主 环 pip 本 章 的 目 
的 是 直 奔 主题 ， 介 绍 如 何 构建 应 用 程序 ， 以 及 如 何 使 应 用 程序 符合 预期 。 但 是 ， 深 
入 了 解 ASPNET Core 的 运行 时 环境 对 于 理解 这 个 平台 的 潜力 以 及 使 用 这 个 平台 的 
最 佳 方式 是 极 有 必要 的 ， 即 使 要 在 不 同 的 操作 系统 上 使 用 ASPNET Core。 因 此 , 全 
面 了 解 ASPNET 系统 十 分 人 必要， 第 14 章 将 完成 这 项 工作 。 
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2.1.2 与 运行 时 环境 人 交互 


所 有 的 ASPNET Core 应 用 程序 都 托管 在 一 个 运行 时 环境 中 ， 并 使 用 一 些 可 用 
的 服务 。 好 消息 是 ， 使 用 多 少 服务 以 及 服务 的 质量 如 何 完全 由 开发 团队 决定 。 你 不 
会 得 到 自己 不 想 使 用 的 服务 。 而 且 ， 要 让 应 用 程序 工作 ， 必 须 显 式 声明 需要 先 运行 
哪些 服务 。 


在 最 初 使 用 ASPNET Core 平台 的 时 候 ， 我 常 犯 的 一 个 错误 是 忘记 请 求 静态 文 
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件 服务 ， 导 致 系统 拒绝 提供 任何 图 片 或 JavaScript 文件 ， 即 使 这 些 文 件 常 被 部 署 到 
了 Web 根 文件 夹 中 ， 


接 下 来 ， 将 更 评 细 地 介绍 应 用 程序 和 和 窒 主 环境 之 间 必 生 的 交互 。 
1. 解析 局 动 类 型 


牡 主 首要 执行 的 任务 之 一 是 解析 局 动 类 型 。 有 两 种 方式 可 显 式 指定 任意 名 称 的 
局 动 类 型 : 使 用 UseStartup<T> 泛 型 扩展 方法 ,或 者 将 该 后 动 类 型 作为 非 泛 型 版 本 的 
参数 。 另 外 ， 也 可 以 传 入 包含 Startup 类 型 的 引用 程序 集 的 名 称 。 

局 动 类 的 惯用 名 称 是 Startup， 但 是 可 以 根据 目 己 的 喜好 进行 修改 。 不 过 ， 有 用 
惯用 名 称 有 额外 的 一 些 好 处 。 特 别 是 ， 在 应 用 程序 中 能 够 配置 多 个 司 动 类 ， 每 个 开 
发 环境 一 个 。 可 以 在 开发 环境 中 使 用 一 个 局 动 类 ， 在 暂 存 环境 或 生产 环境 中 使 用 其 
他 的 局 动 类 。 男 外 ， 如 果 愿 昔 ， 还 可 以 日 定义 开发 环境 。 

假设 项 目 中 有 两 个 类 StartupDevelopment 和 StartupProduction， 并 使 用 下 向 
的 代码 来 创建 答 主 : 

var host = new WebHostBuilder () 

.UseKestrel () 

.UseContentRoot (Directory.GetCurrentDirectory ()) 
.UseIISIntegration () 

.UseStartup (Assembly.GetEntryAssembly() .GetName () .Name) 
.Build(); 

代码 告诉 宿主， 从 当前 的 程序 集 解 析 有 局 动 类 。 在 这 里 ， 箱 主 答 试 找 出 符合 下 面 
午 式 的 一 个 可 加 载 的 类 ，StarupCK， 其 中 CCX 是 当前 宿主 环境 的 和 名称。 默认 情况 
下 ， 牡 主 环境 被 设置 为 Production， 但 是 可 将 其 改 为 任意 字符 串 。 例 如 ， 可 以 改 为 
Staging、Development 或 你 认为 合理 的 其 他 名 称 。 如 采 没 有 设置 特 主 环境 ， 系 统 将 
笑 试 找到 一 个 Startup 茯 ， 如 果 找 不 到 ， 残 抛 出 铅 误 。 

人 稍 言 之 ， 可 以 重 命名 局 动 尖 ， 但 是 更 现实 的 做 法 是 ， 让 笨 主 根据 当前 的 牡 主 环 
卉 解析 局 动 类 。 这 目 然 很 好 ， 但 是 如 何 设置 当前 的 得主 环境 呢 ? 
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2. 宿主 环境 


环境 变量 ASPNETCORE ENVIRONMENT 的 值 指定 了 开发 环境 。 在 Visual 
Studio 项 目 中 , 这 个 变量 默认 被 设 为 Development, 但 也 可 将 其 设 为 其 他 任意 字符 串 ， 
Ul Production 或 Staging。 

在 给 定 操作 系统 上 设置 环境 变量 的 任何 方式 都 可 以 用 来 设置 ASPNETCORE 
ENVIRONMENT 变量 。 例 如 ， 在 Windows 上 ， 可 以 使 用 控制 面板 、PowerShell 或 者 
在 命令 行 上 使 用 set 工具 。 当 然 ， 还 可 以 通过 编程 进行 设置 ， 或 者 在 Visual Studio 中 
使 用 项 目的 Properties 对 话 框 进行 设置 ， 如 图 2-5 所 示 。 记 住 ， 如 果 出 于 某 种 原因 ， 
未 能 设置 ASPNETCORE ENVIRONMENT 变量 ， 将 假定 宿主 环境 是 Production 。 


Application 
Build 
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图 2-5 在 Visual Studio 中 设置 环境 变量 
要 通过 编程 方式 配置 箱 主 环境 ， 需 要 使 用 IHostingEnvironment 接口 的 成 员 ( 参 
见 表 2-2)。 


表 2-2 1IHostingEnvironment 接口 


ApplhcationName 获取 或 设置 应 用 程序 的 名 称 。 宿 主将 此 属性 的 值 设 为 包含 应 用 程序 
入 口 的 程序 集 

EnvironmentName 获取 或 设置 环境 的 名 称 ， 这 个 名 称 会 覆盖 ASPNETCORE 
ENVIRONMENT 变量 的 值 。 可 在 程序 中 使 用 此 属性 的 setter 设置 环境 

ContentRootPath 获取 或 设置 包含 应 用 程序 文件 的 目录 的 绝对 路 径 。 此 属性 第 被 设 为 
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ContentRootFileProvider | ”获取 或 设置 一 个 在 获取 内 容 文件 时 必须 使 用 的 组 件 。 此 组 件 可 以 
是 实现 了 IFileProvider 接口 的 任意 闫 。 堆 认 的 文件 提供 程序 使 用 文 
件 系 统 来 获取 文件 

WebRootPath 犹 取 或 设置 一 个 目录 的 绝对 路 径 ， 此 目录 包 侣 客户 冰 可 通过 URL 
请 求 的 项 态 文件 

WebRootFileProvider 获取 或 设置 一 个 在 获取 Web 文件 时 必须 使 用 的 组 件 。 此 组 件 可 以 
是 实现 了 IFileProvider 接口 的 任意 类 。 默认 的 文件 提供 程序 使 用 文 
件 系 统 来 获取 文件 


IFileProvider 接口 代表 一 个 只 读 的 文件 提供 程序 ， 它 接受 一 个 描述 文件 或 目录 
名 称 的 字符 串 ， 然 后 返回 内 容 的 一 个 抽象 结果 。IFileProvider 接口 还 有 一 种 实现 ， 
能 够 从 数据 库 中 检索 文件 和 目录 的 内 容 。 

答 主 会 创建 一 个 实现 了 IHostingEnvironment 接口 的 对 象 ,， 并 通过 依赖 注入 将 其 
公开 给 局 动 类 和 应 用 程序 中 的 其 他 所 有 类 。 接 下 来 将 评 细 介绍 这 方面 的 内 容 。 


三 | 注意 : 
可 以 选择 向 启动 类 的 构造 函数 传递 两 个 系统 服务 的 引用 : IHostingEnvironment 
和 ILoggerFactory。 后 者 是 ASPNET Core 为 创建 记录 器 组 件 的 实例 做 出 的 抽象 。 


3. 启用 系统 和 应 用 程序 服务 


如 果 定 义 了 ConfigureServices 方法 ， 将 在 调用 Configure 方法 之 前 先 调 用 它 ， 给 
开发 人 员 提 供 机 会 将 系统 和 应 用 程序 服务 连接 到 请 求 管道 。 可 以 在 ConfigureServices 
中 直接 配置 连接 的 服务 ， 也 可 以 推 运 到 调用 Configure 的 时 候 再 进行 配置 。 最 终 选 
择 哪 一 种 方法 取决 于 服务 的 编程 接口 。ConfigureServices 方法 的 原型 如 下 : 


Public void ConfigqureServices (IServiceCollection services) 


可 以 看 到 ， 这 个 方法 接受 一 个 服务 集合 ， 然 后 添加 自己 的 服务 。 一 般 来 说 ， 需 
要 做 大 量 设 置 的 服务 会 在 IServiceCollection 中 提供 一 个 AddXXX 扩展 方法 ， 并 接受 
一 些 参 数 。 下 面 的 代码 片段 省 示 了 如 何 把 Entity Framework 的 DbContext 添加 到 可 
用 服务 列表 中 。AddDbContext 方法 接受 几 个 选项 , 例如 要 使 用 的 数据 库 提 供 程序 和 
实际 的 连接 字符 串 总 
Public void ConfigqureServices (IServiceCollection services) 
{ 
Var Connstring = ™ - 
SeEIVvices.AddDbContext<YourDbContext> (options => options. 
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USseSdlSerVver (connstring) ) ; 


} 


将 服务 添加 到 IServiceCollection 容器 后 ， 通 过 ASPNET Core 内 置 的 依赖 注入 
系统 ， 访 服务 也 将 对 应 用 程序 的 其 余部 分 和 


4. 配置 系统 和 应 用 程序 服务 


Contigure 方法 用 于 配置 HTTP 请 求 管 道 ， 以 及 指定 一 些 有 机 会 处 理 传 入 的 HITP 
请 求 的 模块 。 能 够 添加 到 HITP 请 求 管 道 的 模块 和 松散 代码 合 称 为 中 间 件 。 

Configure 方法 接受 一 个 实现 了 IApplicationBuilder 接口 的 系统 对 象 的 实例 ， 然 
后 通过 该 接口 的 扩展 方法 来 添加 中 间 件 。 另 外 ，Configure 方法 还 可 以 接受 
IHostingEnvironment 和 ILoggerFactory 组 件 的 实例 。 下 向 是 一 个 声明 该 方法 的 例子 。 

public void Configure (lIApplicationBuilder app, IHostingEnvironment em) 

{ 

} 

在 Configure 方法 中 ， 币 见 的 一 个 操作 是 局 用 提供 静态 文件 的 能 力 和 集中 的 销 
误 处 理 程序 。 

public Vvoid Configure (IApplicationBuilder app, IHostingEnvironment env) 

{ 

app.UseExceptionHandler ("/error/view"); 
app.UseStaticFiles ();，; 

} 

扩展 方法 UseExceptionHandler et abn 当 遇 到 无 法 处 理 的 
Application Error 方法 类 似 。 如 果 想 ER 中 ;时 收 到 开 发 人 员 ,提供 的 友好 消 妃 ， 
则 需要 改 用 UseDeveloperExceptionPage 方法 。 然 而 ， 你 可 能 只 想 在 开发 模式 下 看 到 
开发 人 员 提 供 的 友好 消息 。 这 个 场景 为 I[HostingEnvironment 接口 的 一 些 扩展 方法 提 
共 了 很 好 的 用 例 。 


public void Configure (IApplicationBuilder app, IHostingEnvironment enyv) 


{ 
if (env.IsDevelopment{()) 
L 
app.UseDeveloperExceptionPage () ; 
} 
else 
L 
app .UseExceptionHandler ("/Error/View"); 
} 
app.UseStaticFiles (}; 
bl 
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IsDevelopment、IsProduction 和 IsStaging 等 方法 是 预定 义 的 扩展 方法 ， 用 来 检 
但 当前 的 开发 模式 。 如 果 目 定义 了 一 个 环境 ,那么 可 以 通过 IsEnvironment 方法 进行 
检查 。 需 要 注意 ， 在 Windows 和 Mac 上 ， 环 境 名 称 不 区 分 大 小 写 ， 但 在 Linux 上 则 
区 分 。 

因为 在 Configure 中 编写 的 任何 代码 最 终 都 用 于 配置 运行 时 管道 ， 所 以 配置 服 
务 的 顺序 十 分 重要 。 因 此 ， 在 Configure 中 ， 要 做 的 第 一 项 工作 就 是 在 静态 文件 后 
设置 儿 误 处 理 。 


5. 环境 特定 的 配置 方法 


在 司 动 关中 , 也 可 以 使 Configure 和 ConfigureServices 方法 的 名 称 反 映 出 其 体 的 
环境 。 此 时 ， 这 些 方法 的 名 称 为 ConfigureXxx 和 ConfigureXxxServices，Xxx 代表 环 

在 配置 ASPNET Core 应 用 程序 的 局 动 类 时 ， 使 用 默认 的 名 称 Startup 创建 单个 
局 动 类 ， 然 后 通过 UseStartup<T> 问 答 主 注册 这 个 类 ， 可 能 是 最 理想 的 方式 。 之 后 ， 
在 局 动 类 中 ,创建 环境 特定 的 方法 , 如 ConfigureDevelopment 和 ConfigureProduction 。 

牡 主将 根据 当前 设置 的 环境 解析 方法 。 注 意 ， 如 果 重 命名 局 动 关 ， 使 其 名 称 不 
再 是 Startup， 那 么 内 置 的 闫 型 目 动 解析 多 辑 将 会 失败 。 


6. ASP.NET 管道 


IApplicationBuilder 接口 提供 了 定义 ASPNET 管道 结构 的 方法 。 管 道 是 一 个 可 
选 模块 链 ， 这 些 模 块 可 预 处 理 和 后 处 理 传 入 的 HTTP 请 求 ， 如 图 2-6 所 示 。 


胡 地 注 人 系统 
ASPNET 的 依 玩 注 人 系统 


内 置 服务 冀 1 则 j] 慎 


(Kestrel) 


图 2-6 ASPNET Core 的 管道 


党 道 由 中 间 件 组 件 构成 ， 这 些 组 件 在 Configure 中 注册 ， 对 于 每 个 请 求 ， 按 照 
注册 的 顺序 调用 和 它们。 每 个 中 间 件 组 件 都 基于 下 面 的 模 陈 : 


app.Use (async (httpContext, next) 一 > 


{ 
// Pre-process the request 
// Yield to the next middleware module in the chain 
awalt next(); 
// Post-process the request 
}); 
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在 ASPNET 代码 实际 处 理 请 求 之 前 ， 所 有 中 间 件 组 件 都 有 一 次 机 会 来 处 理 它 。 
通过 调用 下 一 个 模块 ， 每 个 中 间 件 组 件 将 请 求 向 下 推送 给 队列 中 的 下 一 个 模块 。 当 
最 后 一 个 注册 的 模块 预 处 理 完 请 求 后 ， 请 求 就 会 执行 。 之 后 ， 反 回忆 有 历 中 间 件 组 件 
链 ， 所 有 的 注册 模块 有 机 会 对 请 求 进行 后 处 理 ， 这 通常 是 通过 查看 更 新 后 的 上 下 文 
及 其 响应 实现 的 。 在 返回 到 客户 端的 过 程 中 ， 按 照 反 向 顺序 调用 中 间 件 模块 。 

可 以 使 用 如 前 所 示 的 代码 段 ， 并 使 用 Lambda 表达 式 编写 代码 ， 来 注册 自己 的 
中 间 件 。 或 者 ， 可 以 把 自己 的 逻辑 放 到 一 个 类 中 ， 然 后 创建 一 个 UseXx 方法 ， 在 
Configure 方法 中 辐 管 道 注 册 这 个 类 。 第 14 章 将 继续 介绍 ASPNET 管道 及 其 定制 。 

在 中 间 件 组 件 链 的 最 后 是 请 求 运 行程 序 ， 即 实际 执行 请 求 的 代码 。 这 段 代码 也 
铝 被 称 为 终止 中 间 件 。 在 经 典 ASPNET 中 ， 请 求 运行 程序 是 动作 调用 者 ， 它 选择 合 
适 的 控制 器 类 , 决定 正确 的 方法 , 然后 调用 这 个 方法 。 不 过 , 如 前 面 所 述 , 在 ASPNET 


Core 中 ，MVC 编程 模型 上 只 是 一 个 选项 。 这 意味 看 请 求 运行 程序 的 形式 更 加 抽象 : 


app.Run (async context => 
{ 
awalt context.Response.WriteAsync("Courtesy of “Programming ASP. 
NET Core™); 


}); 

终 目 中 间 件 处 理 的 代码 是 如 下 形式 的 代理 : 

public delegate Task RequestDelegate (HttpContext context); 

终止 中 间 件 接受 一 个 HttpContext 对 和 象 实 例 作 为 参数 ， 返 回 一 个 任务 。HTTP 上 
下 文 对 象 是 基于 HTTP 信息 的 一 个 容器 ， 这 些 信 息 包括 响应 流 、 身 份 验证 声明 、 输 
入 参数 、 会 话 状态 和 连接 信息 。 

如 果 通 过 Run 方 法 显 式 定 义 终止 中 间 件 ,那么 将 在 该 方法 中 直接 处 理 任 何 请 求 ， 
而 不 需要 控制 器 和 视图 。 实现 了 Run 中 间 件 方法 后 ， 就 能 够 以 最 快 的 方式 处 理 任 何 
请 求 ， 几 乎 没有 开销 ， 而 且 占 用 的 内 存量 也 极 小 。 下 一 节 将 演示 这 个 功能 。 


2.2 依赖 注入 子 系统 


如 果 不 介 绍 依赖 注入 (Dependency Injection，DD 子 系统 ， 那 么 对 ASPNET 运行 
时 环境 的 概述 就 不 能 算 完 整 的 。 


2.2.1 依赖 注入 一 览 


DI 是 一 种 设计 原则 ， 推 时 类 之 间 的 松散 耦合 。 例 如 ， 假 设 有 下 面 的 一 个 拓 : 


public class FlagService 
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private FlagRepository repository; 


Public FlagService () 
{ 
repository = new FlagRepository(); 


} 


Public Flag GetFlagForCountry(string country) 
t 
return reposijtory.GetFlag (country); 
} 
} 
类 FlagService 依赖 于 类 FlagRepository， 考 上 处 到 这 两 个 类 实现 的 任务 ， 紧 密 精 
合 无 法 避免 。DI 原则 帮助 FlagService 与 其 依赖 之 间 存 在 松散 的 关系 。DI 的 核心 理 
念 是 让 FlagService 只 依赖 于 FlagRepository 提供 的 函数 的 抽象 ,在 DI 原则 的 指导 下 ， 
可 以 像 下 面 这 样 重 写 FlagService 类 : 
public class FlagSsService 
{ 
private IFlagRepository repository; 
public FlagService (IFlagRepository repository) 
{ 


repository = repository; 


} 


Public Flag GetFlagForCountry(string country) 
{ 
return repository.GetFlag (country); 
} 
} 
现在 , 任何 实现 了 IFlagRepository 的 类 都 能 安全 地 与 FlagService 类 的 实例 共同 
使 用 。 通 过 使 用 DI， 我 们 把 FlagService 和 FlagRepository 之 间 的 紧密 依赖 转变 成 
FlagService 与 其 需要 从 外 部 导入 的 服务 的 一 个 抽象 之 间 的 松 敌 关系 。 创 建 存储 库 抽 
象 的 实例 的 职责 就 从 服务 类 中 移 除 了 。 这 意味 看 其 他 代码 现在 负责 接受 接口 (抽象 ) 
的 引用 ， 返 回 一 个 具体 类 型 ( 尖 ) 的 可 用 实例 。 每 次 需要 时 ， 可 以 手动 编 与 这 种 代 但 : 
Var repository = new FlagRepository(); 
Var SeITVICe = new FlagService (repository); 
或 者 ， 可 以 让 一 个 专门 的 代码 层 运行 这 段 代码 ， 这 个 代码 层 检查 服务 的 构造 函 
数 并 解析 其 所 有 的 依赖 。 


Var Service = DependencylnjectionSubsystem.Resolve (FlagService),; 


采用 这 种 注入 模式 重 构 类 型 也 有 助 于 编写 单元 测试 ， 因 为 能 够 在 任意 时 刻 把 模 
拟 实现 传递 给 构造 函数 。 
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ASPNET Core 提供 了 自己 的 DI 子 系统 ， 所 以 任何 类 (包括 控制 器 ) 都 能 在 构造 
负数 (或 成 员 ) 中 声明 所 有 必要 的 依赖 ， 系 统 将 确保 创建 和 传递 有 效 的 实例 。 


2.2.2 ASPNET Core 中 的 依赖 注入 


要 使 用 DI 系统 , 系统 必须 能 够 实例 化 一 些 类 型 , 而 你 需要 注册 这 些 类 型 。 ASPNET 
Core 的 DI 系统 已 经 知道 一 些 类 型 ， 如 IHostingEnvironment 和 [LoggerFactory， 但 是 它 
还 需要 知道 应 用 程序 特定 的 类 型 。 接 下 来 介绍 如 何在 DI 系统 中 添加 新 类 型 。 


1. 在 DI 系统 中 注册 类 型 


ConfigureServices 方法 收 到 的 IServicesCollection 参数 是 访问 DI 系统 中 当前 注册 
的 所 有 类 型 的 句柄 。 要 注册 一 个 新 类 型 ， 需 要 在 ConfigureServices 方法 中 添加 代码 。 

Public void ConfigureServices (IServiceCollection services) 

{ 
/ Register a custom type with the DI system 
Services.AddTransient<IF1lagRepository, FlagRepositorv> (); 
} 

AddTransient 方法 告诉 DI 系统 , 每 次 请 求 一 个 抽象 (如 下 lagRepository 接口 ) 时 ， 
提供 FlagRepository 类 型 的 一 个 全 新 实例 。 添 加 这 行 代 码 后 ,由 ASPNET Core 负责 
实例 化 的 任何 类 都 能 够 简单 地 声明 IFlagRepository 类 型 的 一 个 参数 ， 由 系统 提供 一 
个 全 新 实例 。 下 面 显 示 了 DI 系 统 的 第 见 用 法 : 


public class FlagController 
{ 


private IFlagRepository flagRepository; 
Public FlagController (IFlagRepository flagRepository) 
{ 
flagRepository = flagRepository; 
} 


} 

控制 器 和 视图 类 是 使 用 DI 系统 的 ASPNET Core 类 的 和 常见 例子 。 

2. 根据 运行 时 条 件 解析 类 型 

有 时 ， 我 们 想 要 在 DI 系统 中 注册 一 个 抽象 类 型 ， 但 是 需要 在 验证 了 一 些 运行 时 


条 件 (如 追加 的 cookie、HTTP 头 或 查询 字符 串 参数 ) 后 ， 才 决定 具体 的 类 型 。 下 面 给 


Public void ConfigureServices (IServiceCollection services) 


{ 
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services.AddTransient<IFlagRepository> (provider 三 > 


// Create the instance of the actual type to return 

// based on the identity of the currently loggeqd user. 

Var Context = provider.GetRequiredService<IHttpContextAccessor> (); 

return new FlagRepositoryForUser (context.HttpContext .User); 
}); 


} 
注意 , 通过 让 DI 容器 注入 IHttpContextAccessor 的 一 个 实例 , 可 以 在 一 个 HTTP 
上 下 文 不 是 原生 可 用 的 编程 上 下 文中 注入 一 个 HTTP 上 下 文 。 


3. 按照 需要 解析 类 型 


有 些 类 型 有 上 自己 的 依赖 ， 在 一 些 情况 下 ， 需 要 为 这 样 的 类 型 创建 实例 。 
FlagService 是 一 个 很 好 的 例子 , 前面 在 讨论 依赖 注入 时 引入 了 这 个 类 (参见 2.2.1 节 )。 


public class FlagService 


| 
public Flagservice (IFlagRepository repository) 
L 
repository = repository; 
} 
} 


如 何在 创建 一 个 类 实例 的 时 候 不 首先 手动 解析 这 个 类 的 所 有 依赖 ? 注意 ， 依 赖 
可 以 多 层 仍 父 ， 所 以 有 可 能 要 实例 化 一 个 实 ET me 
例 化 其 他 许多 类 型 。 任 何 DI 系统 都 能 够 帮助 解决 这 个 问题 ，ASPNET Core 系统 也 
不 例外 。 

通常 ， 一 个 DI 系统 基于 一 个 称 为 “容器 ”的 根 对 象 ， 容 器 负责 过 历 依 赖 树 并 
解析 抽象 类 型 。 在 ASPNET Core 系统 中 ， IE 接口 代表 容 纶 。 为 了 解 
析 FlagService 实例 ， 有 两 个 选项 : 使 用 经 典 的 new 运算 付 并 提供 IFlagRepository 
实现 依赖 的 一 个 有 效 实例 ;或 者 使 用 IServiceProvider， 如 下 所 示 。 


Var flagService = provider.GetService<FlagService>(); 


要 获得 IServiceProvider 容器 的 一 个 实例 , 只 需要 在 有 和 需要 的 地 方 把 IServiceProvider 
定义 为 构造 函数 的 一 个 参数 ，DI 就 会 注入 期 望 的 实例 。 下 面 给 出 了 一 个 控制 器 的 


例子 : 


public Class FlagController 
{ 
private FlagService services 
Public FlagController{(lServiceProvider provider) 
{ 
SerVice = provider.GetService<FlagSsService> () : 


} 
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} 


注入 IServiceProvider 或 者 注入 实际 的 依赖 对 于 代码 来 说 会 产生 相同 的 效果 。 我 
们 没有 办 法 获得 对 服务 提供 程序 的 静态 、 全 局 引用 。 不 过 ， 在 ASPNET Core 中 ， 
也 不 需要 这 么 做 。 事 实 上 ， 代 但 将 怒 终 在 一 个 文 持 依 赖 注入 的 ASPNET Core 关中 
运行 。 对 于 日 定义 类 ， 只 需要 将 这 些 类 设计 为 通过 构造 函数 据 受 依赖 即 可 。 

4. 控制 对 象 的 生存 期 

有 三 种 不 同 的 方法 可 以 在 DI 系统 中 注册 一 种 类 型 ， 在 每 种 方法 中 ， 所 返回 的 
实例 的 生存 期 各 不 相同 。 表 2-3 介绍 了 这 三 种 方法 。 


表 2-3 ”DI 创建 的 对 象 的 生存 期 选项 


方法 行为 
AddTranslent 每 个 调用 者 会 收 到 为 指定 类 型 新 创建 的 实例 
AddSingleton 所 有 请 求 都 将 收 到 同一 个 实例 ， 即 应 用 程序 局 动 后 为 指定 关 型 第 一 次 


创建 的 那个 实例 。 如 果 由 于 条 种 原因 ， 不 存在 可 用 的 绥 存 实例 ， 束 会 
重新 创建 实例 。 这 种 方法 有 一 个 重 载 方法 ， 人 允许 日 己 传递 实例 ， 以 根 
据 和 需要 级 存 和 返回 

AddScoped 给 定 请 求 中 对 DI 系统 的 每 一 次 调用 会 收 到 同一 个 实例 ， 即 在 开始 处 
理 请 求 时 创建 的 实例 。 这 个 选项 与 创建 单 例 类 似 ， 但 是 其 作用 域 被 限 
定 为 请 求 的 生存 期 


下 面 的 代 但 显示 了 如 何 把 用 户 创 建 的 实例 注册 为 一 个 单 例 。 


Public void ConfigureServices (lIServiceCollection services) 
{ 
Services.AddSingleton<ICountryRepository> (new CountryRepository()); 


} 


每 个 抽象 类 型 可 映射 到 多 个 具体 的 类 型 。 发 生 这 种 情况 时 ， 系 统 会 使 用 最 后 注 
册 的 具体 类 型 来 解析 依赖 。 如 果 找 不 到 具体 类 型 ， 则 返回 null。 如 果 找 到 一 个 具体 
类 型 ， 但 是 无 法 实例 化 这 个 类 型 ， 则 抛 出 一 个 异常 。 


2.2.3 与 外 部 D1 库 集成 


多 年 来 ， 经 典 ASPNET MVC 逐渐 增加 了 目 带 功能 的 定制 程度 。 例 如 ， 在 最 新 
版 本 中 ，IDependencyResolver 接口 定义 了 方法 来 寻找 可 用 的 服务 以 及 解析 依赖 。 相 
比 依赖 注入 框架 ， 它 更 像 是 有 一 个 服务 定位 器 ， 却 提供 了 需要 的 功能 。 服 务 定位 器 
与 依赖 注入 最 大 的 区 别 是 ， 前 者 提供 了 一 个 全 局 对 象 ， 即 服务 定位 器， 必须 显 式 请 
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求 这 个 对 象 来 解析 依赖 。 在 依赖 注入 模式 中 ， 类 型 解析 是 隐 式 进行 的 ， 类 要 做 的 就 
是 通过 注入 点 声明 依赖 。 服 务 定 位 器 模式 更 容易 添加 到 现 有 框架 中 。 依 赖 注 入 模式 
则 是 从 头 构 建 的 框架 的 理想 选择 。 

ASPNET Core 中 的 DI 框架 并 不 是 完善 的 DI 框 和 保 ,无 法 与 业界 顶尖 的 框 染 一 争 。 
它 只 是 做 一 些 基本 的 任务 ， 但 做 得 很 好 ， 能 满足 ASPNET Core 平台 的 需要 。 其 与 
其 他 流行 的 DI 框架 最 大 的 区 别 在 于 注入 点 。 


1 m 注入 点 


一 般 来 说 ， 可 通过 三 种 不 同 的 方式 把 依赖 注入 关中: 作为 构造 函数 中 的 一 个 参 
数 、 在 公共 方法 中 注入 或 者 通过 公共 属性 注入 。 但 是 ，ASPNET Core 中 的 DI 实现 
故 晶 保持 很 简单 ， 不 像 其 他 流行 的 DI 框架 (包括 Microsoft 的 Unity、AutoFac、 
Ninject、StructureMap 等 ) 那 样 完 整 文 持 高 级 的 用 例 。 

在 ASPNET Core 中 ， 故 意 设 计 成 只 能 通过 构造 函数 注入 依赖 。 

但 是 ， 当 在 完全 局 用 的 MVC 环境 中 使 用 DI 时， 可 以 使 用 FromServices 特性 ， 
将 类 的 某 个 公共 属性 或 者 某 个 方法 参数 标记 为 注入 点 。 缺 点 是 ，FromServices 特性 
属于 ASPNET 的 模型 绑 定 层 ， 从 技术 上 讲 不 是 DI 系统 的 一 部 分 。 因 此 ， 只 有 当局 
用 了 ASPNET MVC 引擎 时 才能 使 用 FromServices, 并 只 能 在 控制 旧 类 内 使 用 。 第 3 
章 将 在 介绍 MVC 控制 器 之 后 演示 此 功能 。 


“+ = 
;和 王 忆 : 
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大 部 分 行业 领先 的 DI 框架 都 具备 的 但 是 ASPNET Core 实现 不 支持 的 另 一 个 功 
能 是 将 同一 个 抽象 类 型 映射 到 多 个 具体 类 型 ， 每 个 具体 类 型 都 有 不 同 的 唯一 键 。 通 
过 将 这 个 键 (通常 是 一 个 任意 的 字符 串 ) 传 递 给 服务 提供 程序 ， 可 以 按 特定 的 方式 解 
析 抽 和 象 类 型 。 在 ASPNET Core 中 ,通过 为 抽象 类 型 使 用 工厂 类 或 者 (如 果 可 以 ) 通 过 
基于 回调 的 类 型 解析 ， 可 以 模拟 这 种 功能 。 


2. 使 用 外 部 DI 框架 


如 果 你 认为 ASPNET Core 的 DI 基础 结构 太 过 人 简单， 不 能 满足 你 的 需要 ， 或 者 
如 果 你 的 代码 库 很 庞大 ， 但 是 基于 另外 一 种 DI 框架 ， 那 么 可 以 配置 ASPNET Core 
系统 ， 改 为 使 用 你 选择 的 一 种 外 部 DI 框 架 。 不 过 , 使 用 外 部 DI 框架 的 前 提 条 件 是 ， 
这 个 外 部 框架 必须 文 持 ASPNET Core， 并 且 提 供 一 种 方式 来 连接 到 ASPNET Core 
的 基础 结构 。 

文 持 ASPNET Core 总 味 看 据 供 一 个 与 .NET Core 框架 莱 容 的 类 库 ， 以 及 
IServiceProvider 接口 的 一 个 目 定 义 实 现 。 不 止 如 此 ， 外 部 DI 框架 还 必须 能 够 导入 
在 ASPNET Core 的 DI 系统 中 原生 注册 或 者 通过 代码 注册 的 服务 集合 。 


Public IServiceProvider ConfiqureServices (lServiceCollection services) 
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/ Add some services using the ASP.NET Core interface 
services.AddTransient<IFlagRepository, FlagRepository> (); 


// Create the container of the external DI library 
// Using StructureMap here. 
Var structureMapContainer = new Container (); 


// Add Your own services using the native API of the DI library 


// Add services already registered with the ASP.NET Core DI system 
structureMapContainer.Populate (services),; 


// Return the implementation of IServiceProvider using internally 
// the external library to resolve dependencies 
return structureMapContainer.GetIinstance<IServiceProvider> (); 


} 


需要 重点 注意 , 在 ConfigureServices 中 可 以 注册 外 部 DI 框架 。 不过, 在 注册 时 ， 
必须 在 启动 类 中 把 方法 的 返回 类 型 从 void 改 为 JServiceProvider。 最 后 要 记 住 ， 只 有 
少数 的 DI 框架 被 移植 到 了 .NET Core 中， 其 中 包括 Autofac 和 StructureMap 。 通 过 
Autofac.Extensions.DependencyInjection NuGet 包 可 获得 Autofac for .NET Core。 如 果 对 
StructureMap 感 兴趣 , 可 从 Github 中 获取 该 框 保 , 地址 为 http://github.com/structuremap/ 
StructureMap.Mlcrosott.DependencyInjectlon 。 


2.3 构建 极 简 网 站 


如 前 所 述 ，ASPNET Core 是 一 个 构建 Web 应 用 程序 的 框架 ， 但 是 不 支持 经 典 
ASPNET 的 一 些 应 用 程序 模型 ， 最 明显 的 是 Web Forms 应 用 程序 模型 。 不 过 ， 
ASPNET Core 文 持 ASPNET MVC 应 用 程序 模型 ， 并 且 兼 容 程度 很 高 。 事 实 上 ， 大 
部 分 现 有 的 控制 器 和 Razor 视图 都 可 原样 不 动 地 移植 到 使 用 MVC 服务 的 ASPNET 
Core 应 用 程序 中 。 

实际 上 ,不 使 用 MVC 和 Razor 引擎 ,也 可 以 构建 功能 完整 的 网 站 .ASPNET Core 
平台 的 这 个 方面 使 你 能 够 创建 管道 很 得、 内 存 占用 量 很 小 的 极 简 网 站 。 


注意 : 

使 用 经 典 ASPNET 时 ， 创 建 一 个 内 存 占 用 量 小 的 极 简 网 站 并 不 容易 。 在 经 典 
ASPNET 中 ， 可 禁用 一 些 不 想 使 用 的 HTTP 模块 ， 从 而 减 小 请 求 管 道 的 长 度 ， 但 是 
在 代码 运行 前 会 发 生 很 多 事情 。 据 我 所 知 ， 要 让 自 定义 代码 在 经 典 ASPNET 中 运行 ， 
最 快捷 的 方法 是 使 用 HTTP 处 理 程序 .使 用 ASPX 文件 或 MVC 控制 器 是 做 不 到 这 一 点 
的 。 对 于 Web API 来 说 ， 把 Web API 服务 器 托管 在 ASPNET 网 站 内 并 不 会 改变 什么 。 
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2.3.1 创建 音 痛 点 网 站 


本 书后 面 将 会 详细 讲 到 ， 添 加 到 管道 的 任何 中 间 件 组 件 都 可 以 检 否 和 修改 请 求 
的 每 个 方面 ， 而 且 任 何 中 间 件 组 件 都 能 够 添加 啊 应 cookie 和 头 ， 甚 至 与 入 输出 流 ， 
从 而 为 客户 端 生成 一 些 实际 的 输出 。 

1. Hello World 应 用 程序 


下 面 来 看 看 使 用 ASPNET Core 如 何 创 建 一 个 hello-world Web 应 用 程序 。 使 用 
经 典 ASPNET 是 无 法 创建 极 简 应 用 程序 的 ， 但 是 使 用 ASPNET Core 的 话 ， 则 能 够 
创建 极 答 应 用 程序 ， 只 输出 一 条 人 简单 的 消息 。 代 码 如 下 : 


public Vvoid Configure (IApplicationBuilder app, IHostingEnvironment enV) 


{ 
app.Run(async (context) 三 > 
{ 
awalit context.Response 
.WriteAsync ("Courtesy of <b>Programming ASP.NET Core</b>!"™ + 
-<hr>" 
"ENVIRONMENT=" + env.EnvironmentName).; 
}); 
} 


上 和 面 的 代码 放 在 局 动 类 中 。 除 了 这 段 代 人 码 ， 还 需要 的 只 是 Program.cs 文件 和 一 
个 项 目 文件 。 图 2-7 显示 了 代码 在 浏览 右 中 的 输出 效果 。 


> http://localhost:52416/ 
氏 localhost 和 


Courtesy of Programming ASP.NET Corel 


ENVIRONMENT=Development 


图 2-7 ASPNET Core 中 的 hello-world 应 用 程 厅 
生成 图 中 的 输出 所 需 的 代码 并 不 长 ， 但 是 我 们 可 以 让 这 上段 代码 更 短 。 下 和 耐 这 个 
和 何 单 的 Echo 网 站 将 服务 器 名 后 和 面 的 URL 卢 段 与 了 出 来 : 


USinNng Microsoft.AspNetCore.Hosting; 
USing Microsoft.AspNetCore.Builder; 
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USsSlIng Microsoft.AspNetCore.Http; 


namespace Echo 


{ 


public class Program 


{ 


Public static void Main(string[|] args) 


{ 
Var host = new WebHostBuilder() 
.UseKestrell() 
.UselIlISIntegration'() 
.Confijgure (app => | 
app.Run (async (context) => | 
Var path = context .Request.Path,; 


awalt context.Response.WriteAsync ( Path) ; 
}) 


上 
-Bulilldi(); 
host.Run():; 


} 
其 全 不 需要 局 动 类 和 局 动 文件 。 事实 上 ,终止 中 间 件 直接 连接 到 了 和 窒 主 实例 。 


而 我 们 仍然 能 够 访问 HTTP 请 求 的 内 部 信息 来 确认 源 URL 和 请 求学 付 串 参数 (如 
图 2-8 所 示 )。 和 终止 中 间 件 中 还 有 空间 来 放 入 一 些 极 务 的 业务 逻辑 。 


<€ 全 http://localhost:57807/aspnetcore 
全 localhost x 


/aspnetcore 


图 2-8 ”Echo 示例 应 用 程序 
2. 局 动 网 站 


在 Visual Studio 中 ， 可 以 通过 IIS( 包 括 IIS Express) 或 者 通过 直接 启动 控制 台 应 
用 程序 来 测试 网 站 (如 图 2-9 所 示 )。 


直接 启动 控制 台 应 用 程序 时 ， 应 用 程序 将 会 局 动 ， 并 开始 监听 配置 好 的 端口 ( 默 
认为 问 口 5000)。 同 时 ， 将 打开 一 个 浏览 器 窗口 供 发 出 请 求 ( 如 图 2-10 所 示 )。 
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be Echo - Microsoft Visual Studio Express 2015 for Web 


File Edit View Project Build Debug Team Tools Test Window Help 


] 闪 ~ 号 国 中 | | Debug ™||Any CPU 


-IsEpress “|& ”| 


= 和 Program.cs 呈 并 lIS Express 
a Echo..NETCoreApp,Version=v1.0 lls Express 
1 using Microsof1 cho 
Using Microsofi1 Web Browser (Internet Explorer) 
L 己 了 nn ££ M1 CrPOs 口 十 1 Browse Wuith ... 


More Emulators... 


-namespace Echo 


图 2-9 ”Visual Studio 中 ASPNET Core 应 用 程序 的 启动 选项 


| CNProgram Files\dotnet\dotnet.exe 


Hosting environment: Development 

Content root path: D:\My Demos\Core\Book\Che@3‘\Echo\Echo\bin\Debue\netcoreapp2.8 
New listening on: http:///localhost:61356 

Application started. Press Ctrl+C to shut d 


| re 本 | 
@ 痘 http localhost:61356/healloworld 


总 localhost 


/helloworld 


图 2-10 应 用 程序 在 监听 配置 好 的 端口 


3. 国家 服务 器 


我 们 接 下 来 扩展 这 种 方法 ， 答 试 构建 一 个 很 瘦 但 是 可 以 工作 的 极 简 网 站 。 在 示 
例 中 ， 网 站 将 托 官 一 个 JSON 文件 ， 其 中 包含 一 个 世界 各 国 的 列表 ， 并 根据 请 求 字 
从 串 提 供 的 提示 ， 返 回 一 个 过 小 后 的 列表 。 

建立 Country 极 简 网 站 需要 的 业务 逻辑 就 是 将 JSON 文件 的 内 容 加 载 到 内 存 中 ， 
并 对 这 些 内 容 运 行 几 个 LINQ 查询 。JSON 文件 作为 项 目 文件 被 添加 到 内 容 根 文件 
夹 中 ,并 保持 对 Web 通道 不 可 见 。 有 一 个 存储 库 类 管理 看 极 向 网 站 与 国家 列表 之 间 
的 交互 。 这 个 存储 库 被 抽象 为 ICountryRepository 接口 : 

namespace CoreBook.MinijWeb.Persistence.Abstractions 

{ 

public interface ICountryRepository 
{ 
IQUueryable<Country> All();}; 
Country Findl(string code); 
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IQUueryable<Country> 吕 11BY(StrIng filter}); 
} 


坦白 说 ， 从 尽 可 能 减少 代码 的 角度 看 ， 在 这 里 使 用 接口 来 抽象 国家 存储 库 可 能 
是 大 材 小 用 。 但 是 ， 演 示 代 码 中 采用 的 方法 是 真实 代码 中 局 度 推荐 的 一 种 做 法 ， 人 到 
少 对 于 测试 目的 而 言 如 此 。 存 储 库 注册 到 了 DI 系统 中 ， 并 且 作 为 一 个 单 例 公 开 。 

Public void ConfigqureServices (IServiceCollection services) 

services .addsingqleton<ICountryRepository> (new CountryRepository ()); 

} 

存储 库 的 完整 代码 如 下 。 可 以 看 到 ,这 段 代 人 码 与 在 经 典 ASPNET 应 用 程序 中 为 
完整 的 NET Framework 编写 的 代 人 码 儿 乎 完全 相同 。 唯一 能 够 注意 到 的 微小 区 别 是 读 
取 文 本 文件 的 内 容 所 需要 使 用 的 API。 在 .NET Core 框架 中 , 仍然 有 流 读 取 器 , 但 是 
没有 能 够 接受 文件 名 的 重 载 。 相 反 ， 现 在 有 一 个 File 单 例 对 象 ， 可 更 加 和 直接 地 访问 
文件 内 容 。 

public class CountryRepository : ICountryRepository 


{ 


private static IList<Country> countrijes; 


public IQueryable<Country> All'/() 

{ 
EnsureCountriesAreLoaded () 
return countries.AsQueryable(); 


} 


public Country Findl(string code) 


{ 
return (from C in ALlLlt() 
where c.CountryCode.Equals (code, StringComparison. 
CurrentCulturelgnoreCase) 
select c) .FirstoOorDefault () ， 
} 


public IQueryable<Country> AllBy (string filter) 


{ 
Var normalized = filter.ToLower (); 
return string.IsNulloOrEmpty (filter) 
?2 All() 
: (AL .Wherel(lc => c.CountryName.ToLower () .StartsWith (normalized)) ); 
} 


#region PRIVATE 
private static void EnsureCountriesAreLoaded () 
{ 
1 { countries == null) 
Countrijies = LoadCountriesFromstream!(); 
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private static IList<Country> LoaaCountTriesEFTrOmStTeam  ) 


{ 
Var Json = File.ReadAllText ("countries.J]son™)});? 
Var countries = JsonConvert.DeserializeObject<Country|[|]> (json); 
return countries.OrderBy(c => c.CountryName) .ToList(); 

} 

#endregion 


} 
完整 的 解决 方案 如 图 2-11 所 示 。 


| -' | | EE 


L 
到 下 


Search Solution Explorer (Ctrl+é) 


部 -| 加 -与 


wj Solution 'MiniWeb' (1 project) 
| Solution ltems 
A | src 
4 局 ] MiniWeb 
CP Connected Services 
"四 Dependencies 
~ Properties 
| Persistence 
4 mm Abstractions 
> c* ICountryRepository.cs 
4 后 | Model 
b Cc# Continent.cs 
b Cc# Country.cs 
pb Cc#* CountryRepository.cs 
YJ Countries.json 
C# Program.cs 
ReadMe.txt 
BB Startup.cs 


| Solution... Tearn ExpPl..， Server EX.. 
图 2-11 MiniWeb 解决 方案 
除了 获取 国家 信息 的 业务 逻辑 ， 整 个 应 用 程序 都 基于 局 动 类 中 的 终止 中 间 件 。 


Public void Configure (IApplicationBuilder app, 
IHostingEnvironment enyv, 


ICountryRepository country) 


// NOTE 

// You can inject ICountryRepository through the method's signature or 
// request the DI container (IServiceProvider) through the signature and 
// ask it to resolve ICountryRepository. 

/7 

// var country = provider.GetService<ICountryRepository> () ; 
app.Run(async (context) 三 > 


} 
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{ 
Var duery = Context -Reduest .Query["q"]; 
Var listoOfCountries = country.AllBy (query) .ToList (); 
var JSson = JsonConvert.SerializeObject (1istofCountries); 
awalit context.Response.WriteAsync (json); 
}); 


通过 请 求 字符 串 传 递 的 国家 提示 是 直接 从 HITP Request 对 和 象 获取 的 , 然后 用 来 
过 滤 国 家 。 接 下 来 ， 匹 配 条 件 的 Country 对 和 象 列表 和 被 序列 化 为 SON。 态 外 ，HITP 
Request 对 象 用 来 谈 取 答 询 字符 串 的 API 与 经 典 ASPNET 中 各 有 不同 。 图 2-12 显示 
了 这 个 极 徐 网 站 。 


会 Telerik Fiddler Web Debugger 
File Edit Rules Tooks View Help GET/book Es GeoEdge 


Host URL 的 Statistics 5 Inspectors 天 AutoResponder 且 Composer 目 
www.fiddler2.com /UpdateCheck,aspx?isBetd | Headers | TextView | WebForms | HexView | Auth Cookjes 
localhost:52416 /?q=AU Request Headers En 
GET 7 委 =AU HTTP/T .1 
[Cache 
Pragma: ne-cacdhe 
Client 
Accept: text/html, application/fxhtml+xml; image /jxr, ™/™ 
Acceot-Encoding: azio. deflate 
Get SyntaxView | Transformer Headars | Textiiew | ImageView 
Raw JSON XL 
El- SO0N 
日 -人 0 
Arealnsakim=7686850.0 
:Capital=Canberra 
-= Caontinent=OQC 
continentName=0Qceania 
-=- CouniryCode=AL 
countryName=Australia 
-~ CurrencyCode=AUD 
-Geonameld=2077456 
Languages=en-AU 
Population=21515754 


Arealnsqklim= 旬 3 折 589,0 
r Canital=\Vienna 
Continent=EU 


Expand Al| Collapse JS0N parsing completed., 


http: /Mocalhost: 52416/29=AL 


图 2-12 国家 服务 器 


4. 微服 务 简介 


极 徐 网 站 在 概念 上 类 似 于 专用 的 、 公 司 范围 内 的 内 容 交 付 网 络 。 想象 这 种 场景 : 
你 有 大 量 的 客户 端 代 码 ， 分 布 在 多 个 Web 和 移动 应 用 程序 中 ， 并 且 这 些 代码 在 连续 
地 获取 相同 的 信息 ， 例 如 天 气 预 报 、 用 户 图 片 、 邮 政 编码 或 国家 信息 。 

在 所 有 的 Web 应 用 程序 中 包含 相同 的 数据 检索 逻辑 是 一 种 方法 , 但 是 将 这 种 好 
辑 隅 离 到 一 个 Web API 中 可 以 提高 可 重用 性 和 模块 化 程度 。 隅 离 这 种 逻辑 就 是 微服 
务 的 核心 原则 .如 何 编写 这 种 网 站 呢 ? 在 经 典 ASPNET 中 , 实际 的 请 求 被 处 理 之 前 ， 
会 发 生 很 多 我 们 无 法 控制 的 事情 。 在 ASPNET Core 中 ， 将 能 构建 一 个 极 简 网 站 或 
Web 做 服务 。 
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2.3.2 访问 Web 服务 器 上 的 文件 


在 ASPNET Core 中 ， 对 于 任何 功能 ， 都 必须 先后 用 该 功能 ， 然 后 才能 使 用 。 
启用 功能 的 意思 是 ， 将 合适 的 NuGet 包 添 加 到 项 目 中 ， 癌 DI 系统 注册 该 服务 ， 
然后 在 局 动 类 中 配置 服务 。 这 个 规则 没有 例外 ， 对 于 必须 注册 的 MVC 引擎 也 不 
例外 。 关 似 地 ， 必 须 注册 一 个 服务 来 确保 能 够 访问 Web 根 文件 夹 下 的 静态 文件 。 

局 用 静态 文件 服务 

为 了 能 够 检索 静态 文件 ， 如 HTML 页面、 图 片 、JavaScript 文件 或 CSS 文件 ， 
需要 在 局 动 天 的 Configure 方法 中 浴 加 下 而 一行 代 但 。 

app.UsestaticFiles (); 

这 行 代 人 要求 先 安装 Microsoft.AspNetCore.StaticFiles NuGet 包 。 现 在 ， 可 可 a 
请 求 已 经 配置 好 的 Web 根 文 件 夹 下 的 任何 文件 了 ， 包 括 任 何必 须 原 样 提供 给 客 
疹 ， 而 不 需要 被 任何 动态 代码 (如 控制 器 方法 ) 处 理 的 文件 。 


局 用 病态 文件 服务 并 不 会 允许 用 尸 浏览 指定 目录 的 内 容 。 如 果 也 想 局 用 目录 浏 
希 ， 需 要 诬 加 下 面 的 代 但 。 


Public void ConfigureServices (IServiceCollection services) 


{ 
Services.AddDirectoryBrowsing(); 
} 
public void Configure (IApplicationBuilder app) 
{ 
app.UseStaticFiles (); 
app.UseDirectoryBrowser (); 
} 


添加 了 上 面 的 代码 后 ,就 对 Web 根 文件 夹 下 的 所 有 目录 启用 了 目录 浏览 ， 也 可 
以 限制 为 只 允许 用 尸 浏 览 几 个 目录 。 
public void Configure (IApplicationBuilder app) 
{ 
app.UseDirectoryBrowser (new DirectoryBrowserOptions () 
{ 
FileProvider = new PhysicalFilePpProviderl! 
Path.Combine (Directory.GetCurrentDirectory(), Q@"wwwIroot™", "pics")) 
}); 
} 


中 间 件 添加 了 一 个 目录 配置 ， 只 局 用 了 对 wwwroot/pics 文件 夹 的 浏览 。 如 果 也 
想 尼 用 对 其 他 目录 的 浏览 ， 只 需要 再 写 一 次 UseDirectoryBrowser 调用 ， 改 为 期 望 的 
目录 即 可 。 

注意 ， 毅 态 文件 和 目录 浏览 是 独立 的 设置 。 可 以 同时 局 用 二 者 ， 也 可 以 都 不 局 
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用 ， 或 者 只 局 用 一 个 。 不 过 ， 从 现实 的 角度 看 ， 在 任何 Web 应 用 程序 中 ， 全 少 应 该 
局 用 毅 态 文件 。 


重要/ 


我 们 并 不 建议 启用 目录 浏览 ， 因 为 这 会 让 用 户 能 够 查看 你 的 文件 ， 进 而 知道 你 
的 网 站 的 秘密 。 


2. 启用 多 个 Web 根 文 件 夹 


有 时 ， 除 了 _ wwwroot 中 的 静态 文件 ， 还 想 提 供 其 他 目录 中 的 静态 文件 。 这 在 
ASPNET Core 中 是 可 以 实现 的 ， 只 需要 多 次 调用 UseStaticFiles， 如 下 所 示 。 


public void Configure (IApplicationBuilder app) 

{ 
// Enable serving files from the configured web root folder (i.e., WWHWROOT) 
app.UseStaticFiles(}); 


// Enable serving files from \Assets located under the root folder of the site 
app.UseStaticFiles (new StaticFileOptions () 
{ 
FileProvider = new PhysicalFileProviderl! 
Path.Combine (Directory.GetCurrentDirectory{(}), @"Assets"})), 
ReduestPath = new Pathstring("/Public/Assets") 
}); 
} 


这 段 代 人 码 包 含 对 UseStaticFiles 的 两 个 调用 。 第 一 个 调用 使 应 用 程序 上 只 从 已 经 
配置 好 的 Web 根 文件 夹 (默认 为 wwwroob 提 供 文 件 。 第 二 个 调用 使 应 用 程序 也 能 
够 从 网 站 根 目 录 下 的 Assets 文件 夹 提供 文件 。 但 是 , 在 这 种 情况 下 , 使 用 什么 URL 
来 获取 Assets 文件 夹 中 的 文件 呢 ? 这 正 是 StaticFileOptions 类 的 RequestPath 属性 
的 作用 。 例 如 ， 要 访问 Assets 中 的 testjpg 文件 ， 浏 览 左 应 该 调用 下 面 的 URL: 
/publlc'assets/test.]pg 。 


<IDOCTYPE html> 
<html> 
<head> 
<meta charset="utf-8™ /> 
<title>Programming ASP.NET Core -—— Ch03</title> 
<link rel="stylesheet™ href="/css/site.css" /> 
</head> 
<body> 
<hl>FILE SERVER demo</hl> 
“hr ff» 
<img alt="test"™" src="/public/assets/test.jpg™ /> 
</body> 
</html> 
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如 果 HTML 页 和 面 古 议 态 文件 , 而 不 十 控 制 费 提供 的 动态 标记 ,那么 其 全 HTML 
页 面 也 受到 静态 文件 服务 的 控制 ， 如 图 2-13 所 示 。 
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图 2-13 在 ASPNET Core 中 提供 文件 


注意 ， 对 于 静态 文件 而 言 ， 并 不 存在 一 个 授权 层 来 让 你 控制 哪个 用 户 可 获得 哪 
些 文件 。 所 有 受 静 态 文 件 服务 控制 的 文件 均 被 认为 是 可 公共 访问 的 。 大 部 分 网 站 都 
是 这 样 工作 的 ， 并 不 是 ASPNET Core 应 用 程序 独 有 的 特征 。 

如 果 需 要 对 某 些 静态 文件 应 用 一 定 程度 的 授权 ， 那 么 只 有 一 个 选项 : 把 实际 文 
件 存储 到 wwwroot 以 及 使 用 静态 文件 服务 配置 的 其 他 任何 目录 的 外 部 , 然后 通过 一 
个 控制 器 操作 提供 它们 。 第 3 章 将 更 详细 地 讨论 这 一 点 。 


提示 : 

在 Windows 系统 上 , 文件 名 区 分 大 小 写 , 但 是 在 Mac 和 Linux 上 则 不 区 分 。 如 
果 开 发 的 ASPNET Core 应 用 程序 可 在 IIS 和 Windows 平台 以 外 托管 ， 那 么 应 该 记 
住 这 一 点 区 别 。 


第 2 章 第 一 个 ASPNET Core 项 目 


注意 : 

IIS 有 自己 的 HITP 模块 来 处 理 静 态 文 件 ， 名 为 StaticFileModule。 当 一 个 ASPNET 

Core 应 用 程序 托管 在 JIS 中 时 ，ASPNET Core Module 将 绕 过 默认 的 StaticFileModule。 
日 是 ， 如果 错 误 地 配置 或 者 丢失 了 ASPNET Core Module, 将 不 会 绕 过 StaticFileModule， 

你 将 无 法 控制 如 何 提供 文件 。 为 避免 出 现 这 种 情况 ， 作 为 一 种 额外 的 措施 ， 建 议 为 

ASPNET Core 应 用 程序 禁用 IIS 的 StaticFileModule。 


3. 支持 默认 文件 


默认 Web 文件 是 当 用 户 导航 到 网 站 的 一 个 文件 夹 中 时 有 目 动 提供 的 一 个 HTML 
页 面 。 默 认 页 面 常 被 命名 为 index.* 或 default* ， 可 用 的 扩展 名 为 .html 和 .htm。 这 些 
文件 应 该 放 到 wwwroot 文件 夹 中 , 但 是 除非 添加 了 下 面 的 中 间 件 , 否则 会 忽略 它们 。 


public void Configure (IApplicationBuilder app) 
{ 


app.UseDefaultrFiles (1) ; 
app.UseSsStaticFiles(}); 
} 
注意 ， 必 须 在 局 用 静态 文件 中 间 件 之 前 ， 先 启用 默认 文件 中 间 件 。 特 别 是 ， 默 
认 文件 中 间 件 将 按 下 面 的 顺序 检查 文件 : default.htm、default.html、index.htm 和 
index.html。 在 找到 第 一 个 匹配 结果 后 就 停止 搜索 。 


完全 可 以 重新 定义 默认 文件 名 列表 ， 方 法 如 下 所 示 。 
Var options = new DefaultFilesOptions (); 


options.DefaultrFileNames.Clear (); 
options.DefaultFileNames.Add ("home.html™); 
options.DefaultFileNames .Add ("home.htm"); 
app.UseDefaultriles (options); 


如 琳 不 到 欢 处 理 与 文件 相关 的 不 同类 型 的 中 间 件 , 那么 可 以 考虑 使 用 UseFileServer 
中 间 件 ， 它 将 铬 态 文 件 和 默认 文件 的 功能 结合 起 来 。 注 总，UseFileServer 默认 不 局 用 目 
录 浏 览 ， 但 是 文 持 修改 此 行为 ， 并 且 文 持 添 加 与 UseStaticFiles 和 UseDefaultFiles 中 间 
件 相 同 程度 的 配置 。 

4. 添加 自己 的 MIME 类 型 

静态 文件 中 间 件 可 识别 和 提供 超过 400 种 不 同 的 文件 类 型 。 但 是 ， 如 果 网 站 缺 
少 某 种 MIME 类 型 ， 可 以 将 其 添加 进来 ， 方 法 如 下 所 示 。 

public void Configure (IApplicationBuilder app) 

{ 

// Set up custom content types -~associating file extension to MIME type 


Var provider = new FijleExtensijonContentTypeProvider ();}; 


// Add a new mapping or replace if it exists already 
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provider.Mappings[".script"] = "text/javascript"; 


// Remove JS files 
provider.Mappings.Remove( .J]Ss");}? 


app.UseStaticFiles (new StaticFileOptions () 
{ 
ContentTypeProvider = provider 
}); 
} 
对 于 经 典 ASPNET Web 应 用 程序 , 添加 缺少 的 MIME 类 型 是 在 IS 内 执行 的 一 
a 。 但 是 , 在 ASPNET Core 应 用 程序 中 ,IIS( 以 及 其 他 平台 上 的 Web 服务 
) 只 是 作为 反 向 代理 ， tat triage ASPNET Core 内 置 的 Web 服务 
dl 请 求 将 从 这 里 开始 穿 过 请 求 管道 。 不 过 ， 必 须 通 过 代码 来 配置 这 个 管道 。 


2.4 小结 


本 章 介 绍 了 一 些 示 例 ASPNET Core 项 目 。ASPNET Core 应 用 程序 是 一 个 普通 
的 控制 台 应 用 程序 ， 通 常 在 完善 的 Web 服务 器 (如 IIS、Apache Server 或 NGINX) 内 
和 触发。 但 是 ， 严 格 来 说 ， 并 不 需要 一 个 完整 的 Web 服务 占 来 运行 ASPNET Core 心 
用 程序 。 所 有 ASPNET Core 应 用 程序 都 配 有 目 己 的 一 个 基本 Web 服务 器 (Kestrel)， 
可 通过 配置 的 端口 接受 HITP 请 求 。 

控制 人 台 应 用 程序 构建 了 一 个 牡 主 环 境 ， 在 这 个 环境 中 ， 通 过 一 个 管道 来 处 理 请 
求 。 本 章 只 介绍 了 HTTP 管道 和 Web 服务 器 架构 的 冰山 一 角 ， 并 讨论 了 如 何 创建 极 
人 简 网 站 ， 以 及 可 提供 静态 文件 的 网 站 。 下 一 章 将 介绍 动态 处 理 请 求 ， 以 及 路 由 、 控 
制 妖 和 视图 。 


第 呈 部 分 
ASP.NET MVC 应 用 


程序 局 型 


在 前 面 的 内 容 中 ,已 经 看 到 了 ASPNET Core 的 开发 过 程 ， 以 及 能 够 实现 的 
效 打 。 在 本 部 分 中 ， 我 们 将 探索 其 强大 的 ASPNET 模型 -视图 -控制 费 
(Model-View-Controller，MVOC) 应 用 程序 模型 。 

如 果 你 使 用 过 ASPNET MVC 编写 代码 ， 会 在 这 里 发 现 很 多 郊 悉 的 信 
最 。 事 实 上 ，ASPNET Core 所 实现 的 MVC 概念 不 会 让 Rails 和 Django 等 
平台 或 者 Angular 等 前 端 框 保 的 用 户 感 到 惊奇 。 当 然 ， 细 节 很 重要 ， 所 以 
本 部 分 将 深入 讨论 细节 ， 无 论 你 具有 什么 样 的 育 景 ， 这 都 能 帮助 你 充分 利 
用 ASPNET Core 的 现代 应 用 程序 模型 。 

第 3 革 帮 助 建立 MVC 基础 结构 。 我 们 将 启用 MVC 应 用 程序 模型 ， 注 
册 MVC 服务 ， 局 用 并 配置 路 由 ， 并 了 解 路 由 如 何 纳入 ASPNET MVC 请 求 
的 工作 流 。 

第 4 章 介 绍 ASPNET MVC 应 用 程序 模型 的 要 又, 说 明 控 制 融 如 何 控制 
请 求 处 理 ， 包 括 从 捕捉 输入 一 直到 生成 有 效 的 啊 应 。 

第 5 草 介 绍 框架 的 视图 引擎 。 视 图 引擎 负 贡生 成 浏览 器 能 够 处 理 的 
HTML 标记 。 最 后 ， 第 6 章 介 绍 Microsoft 改进 过 的 Razor 标记 语言 ， 它 能 
够 更 加 简单 、 更 加 高 效 地 构建 现代 HIML 页 面 。 


启动 ASP.NET MVC 


它 不 在 任何 地 图 上 ， 真 正 的 地 方 从 来 都 不 在 地 图 上 。 


赤 尔 受 。 梅 尔 维尔 , 《日 馈 》 


ASPNET Core 完整 文 持 ASPNET 模型 -视图 -控制 器 (MVC) 应 用 程序 模型 。 在 
这 种 模型 中 ， 传 入 请 求 的 URL 人 被 解析 为 一 个 控制 占 / 操 作 项 对 。 控 制 右 项 标识 一 个 
类 名 ; 操作 项 标识 控制 器 类 上 的 一 个 方法 。 因 此 ， 人 处 理 请 求 就 是 执行 给 定 控制 器 类 
的 给 定 操 作 方 法 。 

ASPNET Core 中 的 ASPNET MVC 应 用 程序 模型 与 经 典 ASPNET 中 的 MVC 
应 用 程序 模型 几乎 完全 相同 ， 甚 至 与 其 他 Web 平台 (如 CakePHP for PHP、Rails for 
Ruby 和 Django for Python) 上 相同 MVC 模式 的 实现 也 没有 太 大 区 别 。MVC 模式 在 
前 闹 框 架 (主要 是 Anegular 和 KnockoutUS) 中 也 非常 流行 。 

在 最 终 建 六 ASPNET MVC Core 管道 并 选择 负责 实际 处 理 任 何 传 入 请 求 的 处 理 
程序 之 前 ， 有 一 些 预 备 步 又 要 人 做， 本章 将 介绍 这 些 预 备 步骤 。 


3.1 启用 MVC 应 用 程序 模型 


如 果 在 接触 ASPNET Core 之 前 ， 你 一 直 在 使 用 ASPNET， 那 么 在 ASPNET Core 
中 必须 显 式 局 用 MVC 应 用 程序 模型 这 一 点 可 能 让 你 感到 很 奇怪 。 首 先 ASPNET Core 
是 一 个 通用 性 相当 好 的 Web 框架 , 允许 通过 一 个 集中 的 端点 一 一 终止 中 间 件 一 一 来 
处 理 请 求 。 
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而 且 ，ASPNET Core 还 文 持 一 种 基于 控制 蕉 操作 的 更 复杂 的 病 点 。 但 是 ， 如 采 
想 使 用 这 种 应 用 程序 模型 ， 那 么 必须 启用 该 模型 ， 以 便 能 够 绕 过 终止 中 间 件 ， 即 我 
们 在 第 2 章 讨论 过 的 Run 方法 。 


3.1.1 注册 MVC 服务 


MVC 应 用 程序 模型 的 核心 是 MvcRouteHandler 服务 。 虽 然 有 公开 的 文档 , 但 是 
不 应 该 在 应 用 程序 代码 中 和 直接 使 用 这 个 服务 。 这 个 服务 扮演 的 角色 在 整个 ASPNET 
MVC 机 制 中 全 关 重 要 。MVC 路 由 处 理 程序 负责 将 URL 解析 为 MVC 路 由 , 调用 选 
择 的 控制 器 方法 ， 以 及 处 理 操 作 的 结果 。 


| i 
注意 : 
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MvcRouteHandler 也 是 经 典 ASPNET MVC 实现 中 使 用 的 一 个 类 名 。 然 而 ， 在 
经 典 ASPNET MVC 中 ， 这 个 类 的 作用 要 比 在 ASPNET Core 中 更 有 局 限 性 。 要 从 
整体 上 理解 这 个 类 在 ASPNET Core 中 扮演 的 角色 ， 最 好 直接 查看 其 实现 (网 址 为 
http:/Wbitly/'2kOrKcJ)， 而 不 是 简单 地 依赖 搜索 引擎 。 


1. 添加 MVC 服务 


要 将 MVC 路 由 处 理 程序 服务 添加 到 ASPNET 宿主 , 方式 与 添加 其 他 应 用 程序 
服务 (如 静态 文件 、 喘 份 验 证 或 Entity Framework Core) 相 同 。 只 需要 回 司 动 类 的 
ConfigureServices 方法 添加 一 行 代码 。 


Public void ConfigureServices (lIServiceCollection services) 


{ 
// Package required: Microsoftt .AsPNetCore .Mvc or Microsoft.AspNetCore.All 
(only in 2.0) 
Services.AddMvc () ; 
} 


注意 ， 代 码 要 求 引 用 额外 的 一 个 包 ，IDE( 如 Visual Studio) 一 般 会 提出 替 你 恢复 
这 个 包 。AddMve 方法 有 两 个 重 载 。 无 参数 的 重 载 方法 接受 MVC 服务 的 所 有 默认 
设置 。 下 面 显示 的 是 第 二 个 重 载 ， 允 许 选 择 专 用 的 选项 。 

// Receives an instance of the MvcOptions class 

services.AddMvc (options => 

options.ModelBinderProviders.Add (new SmartDateBinderProvider ()); 


options.SsslPort = 3425 7; 
}); 


选项 是 通过 MvcOptions 类 的 实例 来 指定 的 。 这 个 类 是 一 个 容器 ， 包 含 能 够 在 
MVC 框架 中 修改 的 配置 参数 。 人 例如， 上面 的 代码 片段 添加 了 一 个 新 的 模型 绑 定 器 ， 
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将 特定 的 字符 串 解 析 为 有 效 日 期 , 并 指定 了 用 RequireHttpsAttribute 修饰 控制 右 类 时 
使 用 的 SSL 疹 口 。 在 以 下 网 址 可 找到 可 配置 选项 的 完整 列表 : http://docs.microsoft. 


com/en-us/aspnet/core/apl/microsott.aspnetcore.mvcec.mvcoptions。 
2. 其 他 局 用 的 服务 


AddMvc 是 一 个 综合 性 方法 ， 在 这 个 方法 中 可 以 初始 化 其 他 许多 方法 ， 并 把 它 
们 添加 到 管道 中 。 完 整 列 表 如 表 3-1 所 示 。 


表 3-1 AddMvc 方法 局 用 的 MVC 服务 列表 


服务 摘 述 
MVC Core MVC 应 用 程序 模型 的 一 组 核心 服务 ， 包 括 路 由 和 控制 器 
API Explorer 负责 收集 和 公开 关于 控制 项 和 操作 的 信息 , 供 动 态 友 现 功 能 和 帮助 页 和 面 
的 服务 


提供 身份 验证 和 授权 的 服务 
将 输入 标记 帮助 程序 和 URL 解析 帮助 程序 添加 到 应 用 程序 部 件 列表 的 


服务 

格式 化 程序 映射 设置 默认 媒体 类 型 映射 的 服务 

Razor | 部 在 MVC 系统 中 注册 Razor 视图 和 页 耐 引 擎 

标记 各 助 程 厅 引用 框 染 中 天 于 带 助 程序 的 部 分 的 服务 

数据 注释 引用 框 染 中 天 于 数据 注释 的 部 分 的 服务 

JSON 格式 化 程序 | 将 操作 结 采 处 理 为 JSON 流 的 服务 

CORS 引用 框架 中 关于 踪 域 资源 共 圣 (Cross-Origin Resource Sharing，CORS) 的 
部 分 的 服务 


要 了 解 更 多 细 六 ， 请 丛 看 该 方法 的 源 代 公 : http://bit.ly/213H8QK。 

如 果 存 在 内 存 约 束 ， 例 如 在 云 中 托管 应 用 程序 ， 那 么 可 能 想 让 应 用 程序 只 引用 
最 基本 的 框架 部 分 。 表 3-1 中 的 服务 列表 可 进一步 简化 ， 简 化 多 少 要 取决 于 应 用 程 
序 应 该 实际 具备 的 功能 。 下 面 的 代码 足以 提供 简单 的 、 没 有 高 级 功能 (如 用 于 表单 验 
证 的 数据 注释 和 标记 帮助 程序 ) 的 HIML 视图 。 


Public void ConfigureServices (IServiceCollection services) 


{ 
Var builder = services.AddMvcCore () ， 
builder.AddViews () ; 
builder.AddRazorVliewEngine (); 

} 


但 是 ， 上 面 的 代码 不 足以 返回 格式 化 的 JSON 数据 。 如 果 想 添加 此 功能 ， 只 需 
有 要 沐 加 下 和 的 代位 : 
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builder.AddJsonFormatters().; 


注意 ， 只 有 在 公开 Web API 时 ， 表 3-1 中 的 一 些 服 务 才 是 有 用 的 ， 包 括 API 
Explorer、 格 式 化 程序 映射 和 CORS。 如 果 你 满足 于 获得 经 典 ASPNET MVC 那样 的 
编程 体验 ， 那 么 也 可 以 去 掉 标 记 帮 助 程序 和 默认 的 应 用 程序 部 件 。 


3. 激活 MVC 服务 


在 启动 类 的 Configure 方法 中 ， 调 用 UseMvc 方法 来 配置 ASPNET Core 管道 ， 
以 文 持 MVC 应 用 程序 模型 。 此 时 ， 除 了 传统 路 由 以 外 ，MVC 应 用 程序 模型 的 其 他 
部 分 都 设置 好 了 。 稍 后 将 看 到 ， 传 统 路 由 由 一 组 模式 规则 构成 ， 这 些 规则 标识 了 应 
用 程序 想 要 处 理 的 所 有 有 效 的 URL。 

在 MVC 应 用 程序 模型 中 ， 这 并 不 是 唯一 能 够 将 操作 与 URL 绑 定 起 来 的 方法 。 
例如 ， 如 果 选 择 通过 特性 (第 4 章 将 介绍 ) 把 操作 与 URL 关联 起 来 ， 那 么 工作 就 完成 
了 。 否 则 ， 要 使 MVC 服务 有 效 ， 必 须 列 出 应 用 程序 想 要 处 理 的 URL 路 由 列表 。 

路 由 就 是 应 用 程序 能 够 识别 和 处 理 的 URL 模板 。 它 最 终 将 映射 到 一 对 控制 器 和 
操作 名 称 。 稍 后 将 看 到 ， 可 添加 任意 数量 的 路 由 ， 并 且 这 些 路 由 可 以 是 任意 形式 。 有 
一 个 内 部 的 MVC 服务 负责 路 由 请 求 ; 启用 MVC Core 服务 时 , 会 自动 注册 这 个 MVC 
服务 。 


3.1.2 启用 传统 路 由 


应 用 程序 要 想 有 用 ， 应 该 提供 规则 ， 用 来 选择 其 想 处 理 的 URL。 但是， 并非 必 
须 列举 出 所 有 可 行 的 URL; 只 要 列举 一 个 或 多 个 使 用 了 占 位 符 的 URL 模板 就 足够 
了 。 存 在 一 个 默认 的 路 由 规则 ， 它 有 时 被 称 为 传统 路 由 。 通 常情 况 下 ， 对 于 整个 应 
用 程序 使 用 默认 路 由 就 足够 了 。 


1. 添加 默认 路 由 
如 果 对 于 路 由 没有 要 特别 注意 的 地 方 ， 那 么 最 简单 的 方法 是 只 使 用 默认 路 由 。 


public void Configure (IApplicationBuilder app) 
{ 

app.UseMvcWithDefaultRoute () 
} 


下 和 耐 显示 了 UseMvcWithDefaultRoute 方法 背后 的 实际 代 公 。 


public void Configure (IApplicationBuilder app) 
{ 
app.UseMvc (routes 三 > 
{ 
TOUtes .MapRoute ( 
name: "default™, 
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template: "{controller-Home}/{action=Index}/{id?}"); 

} ); 

根据 上 面 的 代码 ， 任 何 请 求 的 URL 都 将 被 解析 为 以 下 儿 个 片段 : 

e 服务 器 名 后 的 第 一 个 片段 将 匹配 到 一 个 名 为 controller 的 路 由 参数 。 

e 第 二 个 卢 段 将 匹配 到 一 个 名 为 action 的 路 由 参数 。 

e 第 三 个 片段 (如 果 有 ) 将 匹配 到 一 个 名 为 id 的 可 选 路 由 参数 。 

据 此 而 言 ，URL ProducUList 将 匹配 到 一 个 名 为 Product 的 控制 蕉 和 一 个 名 为 List 
的 操作 方法 。 如 果 URL 包含 的 户 段 少 于 两 个 ， 则 将 应 用 默认 值 。 例 如 ， 网 站 的 根 
URL 将 匹配 到 一 个 名 为 Home 的 控制 项 和 一 个 名 为 Index 的 操作 方法 。 默 认 路 由 还 文 
持 另 一 个 可 选 的 片段 ， 其 内 容 匹 配 到 命名 的 值 4。 注意 ，? 从 号 表明 参数 是 可 选 的 。 

路 由 参数 (特别 是 名 为 controller 和 action 的 路 由 参数 ) 在 处 理 传 入 请 求 的 整个 过 
程 中 扮演 看 关键 角色 ， 因 为 它们 通过 某 种 方式 指 癌 了 实际 生成 啊 应 的 代码。 当 请 求 
成 功 地 英 射 到 一 个 路 由 时 ， 将 通过 执行 控制 右 闫 的 一 个 方法 来 处 理 该 请 求 。 名 为 
controller 的 路 由 参数 指出 了 控制 闫 类, 名 为 action 的 路 由 参数 指出 了 要 调用 的 方法 。 
下 一 章 将 详细 讨论 控制 右 。 


2. 未 配置 任何 路 由 时 


调用 UseMve 方法 时 ， 也 可 以 不 提供 任何 参数 。 此 时 ，ASPNET MVC 应 用 程 
序 可 以 工作 ， 但 是 没有 能 够 处 理 的 已 配置 路 由 。 
public vold Configure (IApplicationBuilder app) 
{ 
app.UseMvc (); 
} 


注意 ， 上 和 面 的 代码 与 下 和 耐 的 代码 完全 等 效 : 

app.UseMvc (routes => { }); 

没有 配置 路 由 时 ， 会 发 生 什 么 昵 ? 为 了 实际 看 到 其 效果 ， 我 们 先 简 单 介 绍 简 单 
的 控制 融 类 是 怎样 的 。 假 设 在 项 目 中 添加 了 一 个 新 类 ， 名 为 HomeControllercs， 然 
后 在 地 址 栏 中 调用 URL home/index。 


public class HomeController : Controller 


{ 
public IActionResult Index() 
// Writes out the Home.Index text 
return new ContentResult { Content = “Home .InaeX” 1};}; 


} 
} 


传统 路 由 将 把 URL home/index 映射 到 Home 控制 器 的 Index 方法 。 结 果 ， 应 该 
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看 到 一 个 
的 配置 ， 


2 记 | 站 


全 日 贝 


只 会 得 


面 ， 其 中 显示 了 文本 Home.Index。 但 是 ， 如 果 使 用 传统 路 由 和 上 面 
到 一 个 HTTP 404 页 面 未 找到 错误 。 


现在 我 们 在 管道 中 添加 一 个 终止 中 间 件 ， 然 后 重新 尝试 。 图 3-1 显示 了 新 的 


得 出 。 


app .Run (async (context) 三 > 


{ 


awalt context.Response.WriteAsvyncl 


}); 


“ 工 口 rather say there are no configqgured routes heTre- ): 


念 http://localhost:49844/home/index 


怪 localhost 


Tdrather say there are no contigured routes here. 


图 3-1 应 用 程序 中 没有 配置 任何 路 由 


现在 回 到 的 认 路 由 并 再 次 答 试 。 图 3-2 显示 了 结 打 。 


全 http://localhost:49844/home/index 


全 localhost 


Home . Index 


图 3-2 ”应 用 程序 中 配置 了 默认 路 由 


public void Configure (IApplicationBuilder app) 


{ 


app.UseMvcWithDefaultRoute (); 
app.Run (async (context) 三 > 


{ 


awalit context.Response.WriteAsvyncl( 


}) 


“I'd rather say there are no configured routes here.” ); 
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结论 是 两 面 的 。 一 方面 ， 我 们 可 以 说 ， 使 用 UseMve 改变 了 管道 的 结构 ， 绕 过 
了 可 能 已 经 定义 的 任何 终止 中 间 件 。 另 一 方面 ， 如 果 找 不 到 匹配 的 路 由 或 者 匹配 的 
路 由 无 法 工作 (可 能 是 因为 缺少 控制 器 或 方法 )， 那 么 终止 中 间 件 在 管道 中 重新 占据 
目 己 的 位 置 并 按照 预期 那样 工作 。 

下 面 来 了 解 UseMvc 方法 的 内 部 行为 。 


3. 路 由 服务 与 管道 


在 内 部 ，UseMvc 定义 了 一 个 路 由 生成 堆 服 务 ， 并 将 其 配置 为 使 用 提供 的 路 由 
和 默认 的 处 理 程 序 。 默 认 处 理 程 序 是 MvcRouteHandler 类 的 一 个 实例 。 该 类 负责 找 
到 匹配 的 路 由 ， 以 及 从 模板 中 提取 出 控制 左 和 操作 方法 的 名 称 。 

不 目 如 此 ，MvcRouteHandler 类 还 会 尝试 执行 操作 方法 。 如 果 成 功 执 行 ， 它 将 
把 请 求 的 上 下 文 标记 为 已 经 处 理 ， 这 梓 其 他 中 间 件 束 不 会 册 处 理 已 经 生成 的 啊 应 。 
如 有 果 没 有 成 功 执 行 ， 它 将 使 请 求 在 省 道 中 继续 前 行 ， 直 到 被 完全 处 理 。 图 3-3 用 一 
个 示意 图 总 结 了 这 个 工作 流 。 


找到 并 
运行 路 由 ? 


,| 其 他 中 间 件 


图 3-3 ”路 由 和 管道 


注意 : 
在 经 典 ASPNET MVC 中 ,如 果 没 有 找到 与 URL 匹配 的 路 由 ,将 得 到 HITP 404 
状态 码 。 但 是 ， 在 ASPNET Core 中 ， 任 何 终止 中 间 件 都 将 有 机 会 来 处 理 请 求 。 


3.2 配置 路 由 表 


以 前 ,在 ASPNET MVC 中 ,定义 路 由 的 主要 方法 是 在 一 个 内 存 表 中 添加 URL 
模板 。 需 要 注意 ，ASPNET Core 也 支持 将 路 由 定义 为 控制 器 方法 的 特性 ,在 第 3 章 
中 将 介绍 相关 内 容 。 

无 论 是 通过 表 项 还 是 通过 特性 来 定义 路 由 , 在 概念 上 来 讲 , 路 由 始终 是 相同 的 ， 
始终 包含 相同 数量 的 信息 。 
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3.2.1 路 由 的 剖析 


路 由 在 本 质 上 残 是 一 个 唯一 名 加 上 一 个 URL 模式 。URL 模式 可 以 是 静态 文本 ， 
也 可 以 包含 动态 参数 ， 参 数值 是 从 URL 其 或 整个 HITP 上 下 文中 截取 的 。 下 面 显 
示 了 定义 路 由 的 完整 语法 。 


app.UseMvc (routes 三 > 
{ 
TOUtLesSs .MapRoute ( 

name: “YOUT route"™, 
template: ™ ee 
defauilts: new { controller = "...", action = "... 1}, 
constraints: {| ... }, 
dataTokens: { ... }); 


}) 
template 参数 代表 选择 的 URL 模式 。 如 前 所 述 ， 对 于 默认 的 传统 路 由 ， 它 等 
同 于 : 


{controller}/{action}/{id?]} 


定义 额外 的 路 由 时 ， 可 采取 你 喜欢 的 任意 形式 ， 并 且 可 以 包含 静态 文本 以 及 自 
定义 的 路 由 参数 。defaults 参数 指定 了 路 由 参数 的 默认 值 。template 参数 可 与 defaults 
参数 合并 起 来 。 此 时 ，defaults 参数 将 被 省 去 ，template 参数 则 采用 下 面 的 形式 : 


template: "{controller=Home}/{action=Index}/{id?}" 


如 前 所 述 ， 如 果 在 参数 名 后 面 加 上 ?符号 ， 则 说 明 该 参数 是 可 选 的 。 
constraints 参数 代表 在 特定 路 由 参数 上 设 定 的 约束 , 如 参数 可 接受 的 值 或 者 必 
须 为 什么 类 型 。dataTokens 参数 代表 额外 的 目 定 义 值 , 它们 与 路 由 关联 在 一 起 , 但 
是 不 用 于 决定 路 由 是 人 否 匹配 URL 模式 。 我 们 和 后 将 继续 介绍 路 由 的 这 些 局 级 方面。 


1. 定义 目 定 义 路 由 


传统 路 由 从 URL 的 片段 中 目 动 确定 控制 闫 和 方法 名 称 。 目 定义 路 由 只 是 使 用 
其 他 算法 来 确定 相同 的 信息 。 更 第 见 的 情况 是 ， 目 定义 路 由 由 显 式 映 册 到 控制 絮 / 

虽然 传统 路 由 在 ASPNET MVC 应 用 程序 中 是 相当 营 匈 的 ， 但 是 并 没有 理由 不 
能 定义 额外 的 路 由 。 通 种 并 不 会 茶 用 传统 路 由 ; 相反， 我 们 只 是 添加 一 些 专用 的 路 
由 ， 以 便 有 一 些 目 己 控制 的 URL 来 调用 应 用 程序 的 特定 行为 。 

public vold Configure (IApplicationBuilder app) 


{ 


/ /Custom routes 


app.UseMvc (routes 三 > 
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{ 
routes.MapRoute (name: "route-today", 
template: "today", 
defaults: new 1{ controller="date", action~="day", offset = 0 1});}; 
routes.MapRoute (name: "route-—yesterday"™, 
template: "yesterday', 
defaults: new { controller = "date", action = "day", oftftset = -1 }); 
routes.MapRoute (name: "route-tomorrow , 
template: "tomorrow", 
defaults: new 1{ controller = "date", action = "day", offset = 1 })}); 
}); 


// Conventional routing 
app.UseMvcWithDefaultRoute () ; 


// Terminating middleware 
app.Run (async (context) 三 > 


{ 


awalit context.Response.WriteAsvyncl( 


"I'd rather say there are no configured routes here.™),; 
}); 
} 


图 3-4 显示 了 新 定义 的 路 由 的 输出 。 


<€ http://localhost: 49844/today 
惰 localhost 


Sun, 11 Jun 2018 


< 全 http://localhost:49844/tomorrow 


会 localhost 


Mon, 18 Jun 2018 


< 全 http://localhost:49844/yesterday 
怪 localhost 


Sat, 16 Jun 2018 


图 3-4 新 路 由 


所 有 的 新 路 由 都 基于 一 条 静态 文本 ， 该 文本 映 册 到 控制 器 Date 的 方法 Day。 唯 
一 区 别 在 于 额外 的 路 由 参数 一 一 offset 参 交 的 值 。 要 使 示例 代码 的 结果 如 疼 3-4 
所 示 ， 必 须 在 项 目 中 添加 DateController 类 。 下 和 面 是 一 种 可 能 的 实现 方式 : 
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Public class DateController : Controller 


{ 
public IActijonResult Dayl(int offset) 
{ 


} 

} 

当 调 用 /date/day?offset=1 这 样 的 URL 时， 会 发 生 什么 昵 ? 不 出 所 料 ， 其 输出 与 
调用 /tomorrow 相同 。 这 婚 是 同时 具有 目 定 义 路 由 和 传统 路 由 的 效果 。/date/day/1 这 
个 URL 不 会 被 恰当 地 识别 ， 但 不 会 得 到 一 个 HTTP 404 销 误 或 者 终止 中 间 件 给 出 的 一 
条 消 县 。URL 将 被 解析 为 就 像 调用 了 /today 或 /date/day 那样 。 

正如 所 期 望 的 ，/date/day/1 这 个 URL 不 会 匹配 任何 自 定 义 的 路 由 。 但 是 ， 它 与 
默认 路 由 完美 匹配 。 控 制 器 参数 设 为 Date， 操 作 参 数 设置 为 Day。 默 认 路 由 还 有 一 
个 可 选 的 参数 id， 其 值 是 从 URL 的 第 三 个 片段 提取 的 。 于 是 ， 示 例 URL 的 值 1 被 
赋值 给 了 变量 id, 而 个 是 变量 offset。 传 给 控制 闫 实现 的 Day 方法 的 offset 参数 只 会 
得 到 其 类 型 的 默认 值 ， 对 于 整 型 来 说 为 0。 

为 使 /date/day/1 这 个 URL 表示 今天 过 后 的 下 一 天 ， 必 须 调整 日 定义 路 由 列表 ， 
在 表 的 最 后 添加 一 个 新 路 由 。 

routes .MapRoute (name: "route-day", 


template: "date/day/{offset}", 
defaults: new { controller = "date", action = "day", offset = 0 }); 


甚 全 可 以 像 下 面 这 样 编辑 route-today: 


Froutes .MapRoute (name: "route--today"™, 
template: "today/{offset}", 
defaults: new { controller = "date", action = "day"y, offset = 0 });}; 


现在 , /date/day/ 和 /today/ 后 面 的 任何 文本 将 被 赋值 给 offset 路 由 参数 , 在 控制 器 


类 的 操作 方法 内 可 用 (如 图 3-5 所 示 )。 


人 ©e http://localhost:49844/date/day/8 
全 localhost yw 


Mon, 25 Jun 2018 


<€ http://localhost:49844/today/8 
会 localhost 其 


Mon, 25 Jun 2018 


图 3-5 稍 作 编辑 后 的 路 由 
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现在 ， 你 可 能 会 提出 一 个 很 好 的 问题 : 有 没有 办 法 强制 让 赋值 给 offset 路 由 参 
数 的 文本 是 一 个 数字 ? 这 正 是 路 由 约束 的 作用 。 但 是 ， 在 介绍 路 由 约束 之 前 ， 我 们 
需要 先 介绍 其 他 几 个 主题 。 


重要 / 


无 论 为 请 求 使 用 了 什么 HTTP 动词 ，MapRoute 方法 都 将 URL 映射 到 一 个 控制 
器 /方法 对 。 也 可 以 使 用 其 他 上 映射 方法 ， 如 MapGet、MapPost 或 MapVerb， 来 映射 
到 特定 的 URL 动词 。 


2. 路 由 的 顺序 


使 用 多 个 路 由 时 ， 它 们 在 表 中 出 现 的 顺序 很 重要 。 事 实 上， 路 由 服务 会 从 上 至 
下 扫描 路 由 表 ， 并 评估 其 发 现 的 每 个 路 由 。 遇 到 第 一 个 匹配 的 路 由 时 ， 就 停止 扫描 。 
换 名 话说， 在 路 由 表 中 ， 非 党 具体 的 路 由 应 该 出 现在 更 高 的 位 置 ， 以 便 优先 于 更 通 
用 的 路 由 被 评估 。 

默认 路 由 十 分 通用 ， 因 为 它 直 接 从 URL 确定 控制 器 和 操作 。 它 如 此 通用 ， 甚 至 
可 作为 应 用 程序 中 使 用 的 唯一 路 由 。 我 在 生产 环境 中 创建 的 大 部 分 ASPNET MVC 应 
用 程序 都 只 使 用 传统 路 由 。 

但 是 ， 如 果 你 创建 了 自 定义 路 由 ， 要 确保 先 列 出 它们 ， 然 后 才 启 用 传统 路 由 ; 
否则 , 捕捉 到 URL 的 可 能 会 是 控制 欲 更 强 的 默认 路 由 ,但 要 注意 , 在 ASPNET MVC 
Core 中 ， 捕 捉 URL 并 不 局 限于 提取 控制 器 和 方法 的 名 称 。 只 有 应 用 程序 中 存在 控制 
器 类 和 相关 的 方法 时 ， 才 会 选择 一 个 路 由 。 例 如 ， 考 虑 这 样 一 个 场景 :启用 传统 路 
由 作为 第 一 个 路 由 ， 其 后 列 出 了 我 们 在 图 3-5 中 看 到 的 自 定义 路 由 。 当 用 户 请 求 
/Htoday? 时 ， 会 发 生 什 么 ? 默认 路 由 将 把 它 解析 为 Today 控制 器 和 Index 方法 。 但是， 
如 果 应 用 程序 没有 TodayController 类 或 者 没有 Index 操作 方法 ， 那 么 将 放弃 默认 路 
由 ， 继 续 搜索 下 一 个 路 由 。 

在 表 的 最 底部 ， 在 默认 路 由 的 后 面 添加 一 个 普遍 适用 的 路 由 是 一 个 好 主意 。 普 
遍 适 用 的 路 由 是 一 个 通用 性 相当 强 的 路 由 ， 在 任何 请 求 下 都 能 够 匹配 ， 可 作为 一 个 
恢复 步骤 ， 示 例如 下 所 示 。 

app.UseMvc (routes => 

{ 


/ /Custom routes 


}}s 


// Conventional routing 
app.UseMvyvcWithDefaultRoute ()}); 


// Catch-all route 
app.UseMvc (routes 三 > 


{ 


of 
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routes.MapRoute (name: "catch-all™, 
template: ™“{*url}", 
defaults: new { controller = “error", action = "message™ }); 


}); 


普 遇 适用 的 路 由 上 映射 到 ErrorController 类 的 Message 方法 ， 访 方法 接受 一 个 名 
为 url 的 路 由 参数 。 星 号 表示 此 参数 将 获取 URL 的 剩余 部 分 。 


3. 通过 编程 访问 路 由 数据 


与 请 求 的 URL 匹配 的 路 由 的 相关 信息 保存 在 一 个 RouteData 类 型 的 数据 容 费 
中 。 图 3-6 给 出 了 (在 执行 对 home/index 的 请 求 时 )RouteData 的 内 部 数据 。 


QuickWatch 


Expression: 
RouteData.Values 
Value: 


Name Value 


4 pp RouteData {Microsoft.AspNetCore.Routing.RouteData} 
Db pp Datalokens [Microsoft.AspNetCore.Routing.RouteValueDictionary] 
Db ££ Routers Count = 3 
"2 Values {Microsoft.AspNetCore.Routing.RouteValueDictionary) 
b ££ Comparer {System.OrdinalComparer} 


pp Count 2 
4 fp Keys {string[2)} 
虽 [0] "controller”" 
忆 [1] "action” 
1 pr Values {object[2】) 
2 [0] "Home" 
忆 [1] "Index” 
b ww Non-Public members 
bm Results View Expanding the Results View will enumerate the lIEnumerable 
bw Non-Public members 


图 3-6” ”RouteData 的 内 部 数据 


传 入 的 URL 已 经 匹配 到 默认 路 由 ， 而 URL 模式 决定 了 第 一 个 片段 映射 到 
controller 路 由 参数 ， 第 二 个 卢 段 映射 到 action 路 由 参数 。 路 由 参数 在 URL 模板 中 
由 {parameter} 表 示 法 定义 。{parameter = value} 表 示 法 则 定义 了 参数 的 款 认 值 ， 当 人 缺 
少 给 定 的 片段 时 ， 就 会 使 用 这 个 默认 值 。 通 过 在 程序 中 使 用 下 面 的 表达 式 ， 可 以 访 
问 路 由 参数 : 


Var controller = RouteData.Values|["controller™|; 
Var action = RouteData.Values|"action™|; 


如 有 果 控 制 右 类 是 从 Controller 闫 继承 的 ， 那 么 这 段 代 码 的 效 末 会 很 好 。 

不 过 ,第 4 章 将 看 到 ，ASPNET Core 也 文 持 普 通 传统 CLR 对 象 (Plain-Old CLR 
Object，POCO) 控 制 器 ， 即 不 从 Controller 继承 的 控制 器 类 。 在 这 种 情况 下 ， 路 由 数 
据 的 获取 会 更 复杂 一 些 。 
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public class PocoController 


{ 
private IActljonContextAccessor accessor; 
Public PocoController (IActijonContextAccessor accessor) 
{ 
accessor = accessor;? 
} 
public IActionResult Index() 
{ 
Var controller = accessor.ActionContext.RouteData.Values["controller™]; 
Var action = aAccessor.ActlioncContext.RouteData.Values["action"]; 
var text = string.Format ("{0}.{1}", controller, action)}); 
return new ContentResult { Content = text 1}; 
} 
} 


需要 在 控制 帮 中 注入 一 个 操作 上 下 文 访问 费 。 ASP.NET Core 提供 了 一 个 默认 的 
操作 上 下 文 访问 右 ， 但 是 将 其 绑 定 到 服务 集合 是 开 友 人 员 的 贡 任 。 


Public void ConfigureServices (IServiceCollection services) 


{ 
// More code may go here 
/ Register the action context accessor 
Services.AddSingleton<IActionContextAccessor, ActlionContextAccessor> () 7 
1 


要 在 控制 器 内 访问 路 由 数据 参数 ， 并 非 必须 使 用 这 里 介绍 的 任何 一 种 技术 。 第 4 
章 将 会 看 到 ， 模 型 绑 定 基础 结构 将 根据 名 称 自动 把 HTTP 上 下 文 的 值 绑 定 到 声明 的 
参数 。 


/重要 / 


我 们 不 建议 注入 IActionContextAccessor 服务 ， 因 为 其 性 能 很 差 ， 而 且 更 重要 的 
是 ， 很 少 真 的 需要 注入 该 服务 。 即 使 在 POCO 控制 器 中 ， 模 型 绑 定 也 是 获取 HTTP 
输入 数据 的 一 种 更 清晰 、 更 快速 的 方法 。 


3.2.2 ”路 由 的 高 级 方面 


约束 和 数据 标记 可 进一步 说 明 路 由 的 特征 。 约 束 是 一 种 与 路 由 参数 关联 在 一 起 
的 验证 规则 。 如 末 无 法 通过 约束 验证 ， 则 不 能 匹配 路 由 。 数 据 标记 则 是 与 路 由 关联 
的 简单 信息 ， 供 控制 礁 使 用 ， 但 是 不 用 于 确定 URL 是 合 匹配 路 由 。 


1. 路 由 约束 
从 技术 上 讲 , 约束 是 一 个 实现 了 了 芒 outeConstraint 接口 的 类 ， 负 责 验证 传递 给 特 
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定 路 由 参数 的 值 。 例 如， 可 以 使 用 约束 , 确保 只 有 当 给 定 参数 收 到 期 望 类 型 的 值 时 ， 
才 匹 配 路 由 。 下 向 演示 了 如 何 定义 一 个 路 由 约束 : 


app.UseMvc (routes => 
{ 
routes.MapRoute (name: "route-today", 
template: "today/{offset}", 
defaults: new { controller="date", action="day", offset=0 | 
constraints: new { offset = new IlIntRouteConstraint() }); 


ls 

在 示例 中 ， 路 由 的 offset 参数 受 IntRouteConstraint 类 的 操作 的 限制 ，IntRouteConstraint 

是 ASPNET MVC Core 框 染 中 的 一 个 预定 义 约束 类 。 下 面 的 代码 显示 了 一 个 约束 类 
的 肖 架 : 


// Code adapted from the actual implementation of IntRouteConstraint class. 
public Class IntRouteConstraint : IJRouteConstraint 
{ 
public bool Matchi 
HttpContext httpContext, 
TRouter route, 
string routerRey, 
RouteValueDictionary values, 
RouteDirection routeDirection) 


{ 
obJject value; 
1if (values.TryGetValue (routeKey, out Valuej && value = null) 
L 
1ft (value 1is int) return true; 
int result; 
var VvalueSstring = Convert.ToString (value, CultureInfo.TInvarijantCulture); 
return int.TryParse (valueSstring, 
Numberstyles.Integer, 
CulturelInfo.InvariantCulture, 
out result); 
} 
return false; 
} 


} 
约束 类 从 路 由 值 的 字典 中 提取 routeKey 参数 的 值 ， 并 进行 合理 的 检查 。 
IntRouteConstraint 类 只 是 人 简单 地 检查 这 个 值 是 奋 能 够 被 成 功 地 解析 为 一 个 整数 。 
注意 ， 约 束 可 以 关联 一 个 唯一 名 称 字符 串 ， 用 来 解释 该 约束 的 使 用 方法 。 约 束 
名 可 用 于 更 简洁 地 指定 约束 。 
routes .MapRoute (name: "route-day", 


template: "date/day/{offset:int}", 
defaults: new { controller = "date", action = "day"y, offset = 0 }); 


IntRouteConstraint 类 的 名 称 是 int, 表示 {offset:int} 将 该 类 的 操作 与 offset 参数 关 
联 在 一 起 。IntRouteConstraint 是 ASPNET MVC Core 中 的 预定 义 路 由 约束 类 之 一 ， 
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这 些 预 定义 约束 类 的 名 称 在 局 动 时 设 定 并 有 完整 的 文档 。 如 来 创建 目 定 义 约束 类 ， 
则 应 该 在 回 系 统 注 册 该 约束 尖 时 设置 其 名 称 。 


Public void ConfigqureServices (IServiceCollection services) 


{ 


SeErVvices.Configure<Routeoptions> (options => 


] 


optijons.ConstraintMap.Add ("your-route"™, 


typeof (YourRouteConstraint))); 


现在 可 以 使 用 {fparametermame:constraintprefix} 表 示 法 将 约束 绑 定 到 给 定 的 路 由 


2. 预定 义 路 由 约束 
表 3-2 给 出 了 预定 义 路 由 约束 的 列表 以 及 这 些 约束 的 映射 名 。 


Int 

Bool 
datetime 
decimal 
double 

Float 

Guid 

Long 
minlength(N) 


maxlenegth(N) 


length(N) 
max(N) 
range(M,N) 
alpha 
regex(RE,) 


required 


表 3-2 


IntRouteConstramt 


BoolRouteConstramt 
DateTimeRouteConstramt 
DecimalRouteConstramt 
DoubleRouteConstramt 
FloatRouteConstramt 
GudRouteConstramt 
LongRouteConstramt 
MinLengthRouteConstramt 


MaxLengthRouteConstramt 


LengthRouteConstramt 
MinRouteConstramt 
MaxRouteConstramt 
RangeRouteConstramt 


AlphaRouteConstramt 


RegexInlmeRouteConstramt 


RequiredRouteConstramt 


预定 义 路 由 约束 


描述 
确保 路 由 参数 被 设 为 整数 
确保 路 由 参数 被 设 为 布尔 但 
确保 路 由 参数 被 设 为 有 效 的 日 期 
确保 路 由 参数 被 设 为 小 数 
确保 路 由 参数 被 设 为 双 精 度数 
确保 路 由 参数 被 设 为 浮 扣 数 
确保 路 由 参数 被 设 为 GUID 
确保 路 由 参数 被 设 为 长 整 型 
确保 路 由 参数 被 设 为 不 小 于 指定 长 度 的 字 
衙 串 
确保 路 由 参数 被 设 为 不 大 于 指定 长 度 的 字 
符 串 
确保 路 由 参数 被 设 为 指定 长 度 的 字符 串 
确保 路 由 参数 被 设 为 大 于 指定 值 的 整数 
确保 路 由 参数 被 设 为 小 于 指定 值 的 整数 
确保 路 由 参数 被 设 为 指定 值 区 间 内 的 整数 
确保 路 由 参数 被 设 为 字母 字符 构成 的 字符 串 
确保 路 由 参数 被 设 为 符合 指定 正则 表达 式 的 
字符 哩 
确保 路 由 参数 在 URL 中 被 赋值 
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你 可 能 已 经 注意 到 ， 预 定义 路 由 约束 列表 中 未 包含 一 个 相当 币 见 的 约束 : 确保 
路 由 参数 的 值 来 日 一 个 已 知 值 的 集合 。 要 用 这 种 方式 约束 参数 ， 可 以 使 用 一 个 正则 
表达 式 ， 如 下 有 所 示 。 


{lformat:regex(]json|zxml |text)} 


只 有 当 format 参数 的 值 为 列 出 的 子 字符 串 之 一 时 , URL 才 会 匹配 包含 此 format 
参数 的 路 由 。 

3. 数据 标记 

在 ASPNET MVC 中 ， 路 由 并 不 限于 只 使 用 URL 内 的 信息 。URL 片段 用 来 确 
定 路 由 是 否 与 请 求 相 匹配 , 但 是 路 由 也 可 以 关联 额外 的 信息 , 在 以 后 通过 编程 获取 。 
要 在 路 由 上 附加 额外 的 信息 ， 需 要 使 用 数据 标记 。 

数据 标记 是 用 路 由 定义 的 ， 本质 上 只 是 一 个 名 称 / 值 对 。 任何 路 由 都 可 以 有 任意 
数量 的 数据 标记 。 数 据 标记 是 目 由 选择 的 信息 ， 不 用 于 将 URL 匹配 到 路 由 。 


app.UseMvc (routes 三 > 


{ 
routes.MapRoute (name: "catch-all™, 
template: ™v{*url}"™", 
defaults: new 1{ controller = "home", actijion = "index” }, 
constraints: new { }, 
dataTokens: new { reason = "catch-—all™ 1}); 
}); 


在 ASPNET MVC 路 由 系统 中 ， 数 据 标 记 并 不 是 关键 的 、 必 须 具 有 的 功能 ， 但 
是 有 时 它们 十 分 有 用 。 例 如 ,假设 普 壳 适 用 的 路 由 映射 到 一 个 控制 器 /操作 对 ， 但 
是 该 控制 右 / 操 作对 也 用 于 其 他 目的 。 再 假设 , Home 控制 占 的 Index 方法 用 于 一 个 
不 匹配 任何 路 由 的 URL。 我 们 的 想法 是 ， 如 果 不 能 确定 比较 具体 的 URL， 束 显示 
让 页 8 

如 何 区 分 二 接 请 求 的 主页 和 痊 过 适用 的 路 由 显示 的 主页 呢 ? 数据 标记 是 一 种 选 
择 。 下 面 显示 了 如 何 用 代码 获取 数据 标记 。 


var catchall = RouteData.DataTokens["reason™ | ?2 ”1 


数据 标记 是 用 路 由 定义 的 ， 但 只 能 在 代码 中 使 用 。 


3.3 ” ASP.NET MVC 的 机 制 


处 理 HITP 请 求 并 生成 啊 应 是 一 个 相当 长 的 过 程 ,路 由 上 只 是 这 个 过 程 的 第 一 步 。 
路 由 过 程 的 最 终结 果 是 一 个 控制 右 / 操 作对 , 它 将 处 理 没有 映射 到 物理 静态 文件 的 请 
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求 。 第 4 章 将 详细 介绍 控制 器 类 , 这 是 任意 ASPNET MVC 应 用 程序 的 中 央 控 制 台 。 
但 是 ， 在 那 之 前 ， 我 们 需要 先 了 解 整体 的 ASPNET MVC 机 制 。 

事实 上 ， 在 本 书 的 剩余 部 分 ， 我 们 将 关注 这 个 机 制 的 不 同 部 分 ， 说 明 如 何 配置 
和 实现 它们 ， 但 是 从 整体 上 了 解 这 个 机 制 以 及 各 个 组 件 之 间 的 关系 是 很 有 帮助 的 ， 
如 图 3-7 所 示 。 


请 求 的 URL 


操作 调用 程序 


授权 科 选 检 


模型 绑 定 


“操作 往 选 台 


操作 


把 
斥 
二 
二 


结果 筛选 器 年 本 
图 3-7 ASPNET MVC 请 求 的 完整 路 由 


不 能 映 册 到 裔 态 文 件 的 HTTP 请 求 将 触发 此 机 制 。 首先 , URL 将 通过 路 由 系统 ， 
映射 到 一 个 控制 器 名 和 一 个 操作 名 。 


本 章 并 未 区 分 术语 “操作 ”和 “方法 ”。 在 目前 的 抽象 级 别 上 ， 互 换 使 用 这 两 个 
术语 没有 问题 。 但 是 ， 在 ASPNET MVC 的 整体 架构 中 , “操作 ”的 概念 与 “方法 ” 
的 概念 是 相关 但 是 不 相同 的 。 术 语 “ 方 法 ” 指 的 是 在 控制 器 类 中 定义 但 是 没有 用 
NonAction 特性 标记 的 一 个 首 通 公有 方法 。 这 种 方法 常 被 称 为 “操作 方法 ”。 术语 “ 操 
作 ” 指 的 是 在 控制 器 类 上 调用 的 操作 方法 的 名 称 字 符 串 。 按 照 约定 ，action 路 由 参 
数 的 值 通常 匹配 到 控制 器 类 的 一 个 操作 方法 的 名 称 。 不 过 ， 在 下 一 章 将 看 到 ， 可 以 
实现 一 种 间接 匹配 ， 将 使 用 自 定 义 名 称 的 方法 映射 到 一 个 特定 的 操作 名 称 。 


3.3.1 操作 调用 程序 


操作 调用 程序 是 整个 ASPNET MVC 基础 结构 的 核心 ， 负 责 协调 所 有 必要 的 步 
又 来 处 理 请 求 。 操 作 调用 程序 接受 控制 器 工厂 和 控制 器 上 下 文 ， 后 者 是 一 个 容器 对 
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象 ， 包 含 路 由 数据 和 HTTP 请 求 信息 。 如 图 3-7 所 示 ， 操 作 调 用 程序 运行 目 己 的 操 
作痛 选 器 管道 ， 并 为 一 些 专用 的 应 用 程序 代码 提供 挂钩 ， 使 其 在 实际 执行 请 求 乙 前 
和 之 后 运行 。 

操作 调用 程序 使 用 反射 来 创建 选 定 控制 器 类 的 实例 以 及 调用 选 定 的 方法 。 在 这 
个 过 程 中 ， 调 用 程序 还 会 谈 取 HTTP 上 下 文 、 路 由 数据 和 系统 的 DI 容 费 ， 以 解析 
方法 和 构造 函数 的 参数 。 

在 下 一 草 将 会 看 到 ， 任 何 控制 问 方 法 都 应 该 返回 一 个 包 冯 到 IActionResult 容 髓 
中 的 对 象 。 控 制 需 方法 只 是 返回 数据 ， 用 于 生成 实际 啊 应 ， 而 啊 应 将 被 友 回 客户 端 。 
控制 堪 方 法 并 不 负责 直接 与 入 啊 应 得 出 流 。 欣 制 器 方法 确实 可 通过 代码 访问 啊 应 输 
出 流 ， 但 推荐 的 模式 是 让 控制 器 方法 将 数据 打包 到 一 个 操作 结果 对 象 中 ， 然 后 告诉 
操作 调用 程序 如 何 进 行进 一 步 处 理 。 


注意 : 
关于 ASPNET MVC 的 操作 调用 程序 的 实际 行为 ， 可 参考 类 ControllerActionInvoker 
的 实现 来 获取 更 多 信息 ， 网 址 为 http://bit.ly/2kKkQfNAA。 


3.3.2 ”处 理 操作 结果 


控制 器 方法 的 操作 结果 是 一 个 实现 了 IActionResult 接口 的 类 。 针 对 控制 器 方法 
可 能 想 要 返回 的 输出 类 型 ， 如 HTML、JSON、 纯 文本 、 二 进 制 内 容 和 特定 的 HTTP 
响应 ，ASPNET MVC 框架 定义 了 几 个 这 样 的 类 。 

该 接口 只 有 一 个 方法 : ExecuteResultAsync。 操 作 调 用 程序 调用 这 个 方法 ， 将 类 
据 仍 入 要 处 理 的 特定 操作 结果 对 象 中 。 执 行 操 作 结果 的 最 终 效果 是 写 入 HITP 响应 
合 出 第 选 硕 。 

接 下 来 ， 操 作 调 用 程序 运行 其 内 部 管道 并 返回 啊 应 。 客 户 端 (通常 是 浏览 嚣 ) 将 
收 到 任何 生成 的 输出 。 


3.3.3 操作 炳 选 器 


操作 簿 选 器 是 围绕 控制 器 方法 运行 的 一 段 代 码 。 最 第 见 的 操作 科 选 器 是 在 控制 
器 方法 执行 之 前 或 者 之 后 运行 的 筛选 器 。 例 如 ， 可 以 让 操作 筛选 器 只 是 向 一 个 请 求 
添加 一 个 HTTP 头 ; 也 可 以 当 请 求 不 是 来 自 Ajax， 或 者 来 自 一 个 未 知 的 卫 地 址 或 
来 源 URL 时 ， 让 操作 筛选 器 拒绝 运行 控制 器 方法 。 

可 通过 两 种 方式 来 实现 操作 筛选 器 : 作为 控制 器 类 内 的 方法 重 写 ， 或 者 更 好 的 
方法 是 ， 作 为 一 个 特性 类 。 第 4 章 将 详细 介绍 操作 筛选 器 。 
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3.4 小 结 


从 架构 上 来 讲 ， 关 于 ASPNET Core 的 最 重要 的 事实 是 ， 这 是 一 个 真正 的 Web 
框架 ， 只 能 用 来 构建 HITP 前 端 。 它 并 不 限制 你 使 用 特定 的 应 用 程序 模型 。 相 比 而 
言 ， 经 典 ASPNET 是 捆绑 了 特定 应 用 程序 模型 的 一 个 Web 框架 ， 这 个 模型 可 能 是 
Web Forms， 也 可 能 是 MVC。 

ASPNET Core 提供 了 开放 的 中 间 件 ， 供 你 根据 需要 添加 使 用 ， 以 接受 和 处 理 传 
入 的 请 求 。 在 ASPNET Core 中 ， 可 以 让 代码 监听 通信 端口 ， 捕 捉 任 何 请 求 并 返回 
啊 应 。 整 个 流程 可 以 只 涉及 你 、HITP 和 你 的 代码 ， 不 需要 任何 中 介 。 然 而 ， 也 可 
启用 一 个 更 复杂 的 应 用 程序 模型 ， 如 MVC。 此 时 ， 必 须 完 成 一 些 相关 的 任务 ， 例 
如 定义 应 用 程序 能 够 识别 的 URL 模板 ， 以 及 负责 处 理 请 求 的 组 件 。 本 章 关 注 的 是 
URL 模板 和 请 求 路 由 。 第 4 章 将 介绍 负责 实际 处 理 请 求 的 控制 左 。 
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“ 哈 元 ， 每 个 人 都 是 这 样 的 .” 
“汤姆 ， 我 跟 别人 不 一 样 .” 
一 一 马克 吐 温 ，《 汤 姆 。 索 亚 历 险 记 》 


虽然 ASPNET MVC 应 用 程序 模型 在 名 称 中 明确 提 到 了 模型 -视图 -控制 如 模式 ， 
但 是 这 个 模型 在 本 质 上 围绕 看 一 个 核心 一 一 控制 砷 。 控 制 融 管理 看 请 求 的 整个 处 理 
过 程 。 它 捕捉 输入 数据 ， 协调 业 务 层 和 数据 层 的 活动 ， 在 为 请 求 计算 出 原始 数据 后 ， 
最 终 将 整个 原 巡 的 数据 包 汪 成 有 效 的 啊 应 返回 给 调用 方 。 

任何 经 过 URL 路 由 和 希 选 问 的 请 求 都 被 映射 到 一 个 控制 磊 关 ， 并 通过 执行 该 类 
的 特定 方法 来 处 理 。 因 此 ， 开 发 人 员 在 控制 融 类 中 编写 代码 来 处 理 请 求 。 我 们 将 价 
单 讨论 控制 费 类 的 一 些 特征 ， 包 括 其 实现 细 市 。 


4.1 控制 器 类 


编写 控制 希 关 的 步 又 可 总 结 为 两 个 : 实现 一 个 类 ， 然 后 在 该 类 中 添加 一 些 公 有 
方法 ,在 运行 时 该 类 可 作为 控制 融 被 友 现 ,而 这 些 方法 则 可 作为 操作 被 友 现 。 然 而， 
还 需要 解释 清楚 两 个 重要 的 细 攻 : 系统 如 何 知道 实例 化 哪个 控制 费 类 ， 以 及 如 何 确 
定 调用 哪个 方法 。 
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4.1.1 发 现 控制 器 的 名 称 


MVC 应 用 程序 收 到 的 只 是 一 个 待 处 理 的 URL, 这 个 URL 必须 以 某 种 方式 映射 
到 一 个 控制 器 类 和 一 个 公有 方法 。 无 论 采 用 了 什么 路 由 策略 ， 你 都 可 能 选择 (使 用 传 
统 路 由 、 特 性 路 由 或 者 二 者 均 使 用 ) 来 填写 路 由 表 。 最 终 , 将 根据 系统 路 由 表 中 注册 
的 路 由 将 URL 映射 到 控制 器 。 

1. 通过 传统 路 由 发 现 


如 果 发 现 传 入 的 URL 匹配 到 某 个 预定 义 的 传统 路 由 ， 那 么 通过 解析 路 由 将 得 
到 控制 器 的 名 称 。 如 前 一 章 所 述 ， 默 认 路 由 的 定义 如 下 : 


app.UseMvc (routes 三 > 


{ 
FoOutes .MapRoute ( 
name: "default™, 
template: "{controller=Home}/{action=Index}/{id?}"); 
}); 


控制 器 名 称 是 从 URL 模板 参数 推 亲 出 来 的 。URL 中 在 服务 嚣 名称 之 后 的 第 一 
个 片段 就 是 控制 器 名 称 。 传 统 路 由 通过 显 式 的 或 者 隐 式 的 路 由 参数 来 设置 控制 器 参 
数 的 值 。 显 式 路 由 参数 被 定义 为 URL 模板 的 一 部 分 ， 如 上 和 而 所 示 。 隐 式 路 由 参数 
不 会 出 现在 URL 模板 中 ， 它 们 被 视 为 剃 量 来 处 理 。 在 下 例 中 ，URL 模板 为 today， 
控制 器 参数 的 值 通 过 路 由 的 defaults 属性 静态 设置 。 


app.UseMvc (routes 三 > 


{ 
TOULeS .MapRoute ( 
name: "route-today", 
template: "today"™, 
defaults: new { controller="date", action="day", offset=0 1});}; 
} 


注意 ， 从 路 由 推断 的 控制 郑 值 不 一 定 是 所 使 用 的 控制 器 突 的 准确 名 称 。 蝎 利多 
的 情况 是 ， 推 类 出 的 名 称 是 一 种 昵称 ， 但 并 非 总 是 如 此 。 因 此 ， 可 能 需要 做 一 些 额 
外 的 工作 来 把 控制 右 值 转换 为 实际 的 类 名 。 

2. 通过 特性 路 由 发 现 

特性 路 由 允许 使 用 特殊 的 特性 来 修饰 控制 占 类 或 方法 ， 这 些 特性 指出 了 最 终 将 
调用 方法 的 URL 模板 。 特 性 路 由 最 主要 的 好 处 是 让 路 由 的 定义 接近 其 对 应 的 操作 。 
这 样 一 来 ， 无 论 是 谁 在 阅读 代码 ， 者 可 以 清楚 地 知道 该 方法 何 时 以 及 如 何 衫 调用 。 
而 且 ， 选 择 特性 路 由 可 使 URL 模板 与 处 理 请 求 时 使 用 的 控制 项 和 操作 保持 独立 。 
以 后 ， 即 使 由 于 发 展 或 者 营销 的 原因 修改 了 URL， 也 不 需要 重 构 代 但。 
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[Route ("Day™)| 
Public class DateController : Controller 
{ 
[Route ("{offset}")] // Serves URL like Day/l 
public ActionResult Details (int offset) { ... } 
} 


通过 特性 指定 的 路 由 仍 将 进入 应 用 程序 的 全 局 路 由 表 ， 也 融 是 使 用 传统 路 由 时 
通过 代 但 显 式 项 充 的 那个 表 。 


3 通过 混合 路 由 策略 发 现 


传统 路 由 和 特性 路 由 并 不 是 互 斥 的 。 二 者 可 用 在 同一 个 应 用 程序 中 。 特 性 路 由 
和 传统 路 由 填写 相同 的 路 由 表 , 用 于 解析 URL。 由 于 必须 通过 编程 来 添加 传统 路 由 ， 
因此 必须 显 式 局 用 传统 路 由 。 特性 路 由 始终 是 打开 的 , 不 需要 显 式 局 用 。 注意 ，Web 
API 和 之 前 版 本 的 ASPNET MVC 中 的 特性 路 由 并 非 如 此 。 

特性 路 由 始终 是 打开 的 ， 导 臻 通过 特性 定义 的 路 由 比 传 统 路 由 的 优先 级 更 高 。 


4.1.2 ”继承 的 探 制 问 


控制 器 类 通 钊 直接 或 间接 继承 目 基 类 Microsoft.AspNetCore.Mvc.Controller。 注 
葵 ， 在 ASPNET Core 之 前 发 布 的 所 有 版 本 的 ASPNET MVC 中 ， 严 格 要 求 继承 
Controller 基 关 。 但 在 ASPNET Core 中 ,也 可 让 没有 继承 任何 功能 的 普通 C# 关 作为 
控制 品类 。 后 面 将 更 详细 地 介绍 这 种 类 型 的 控制 器 类 ， 全 于 现在 ， 我 们 先 假定 控制 
需 关 必须 从 一 开始 承继 承 了 系统 的 基 关 。 

当 系 统 成 功 解 林 了 路 由 后 ,了 驶 会 有 一 个 控制 器 名 称 。 这 个 名 称 只 是 一 个 字符 串 ， 
是 一 种 昵称 。 这 个 昵称 (如 Home 或 Date) 必 须 与 项 目 中 包含 或 者 引用 的 某 个 丰 实 的 
类 相 匹 配 。 


1. 带 后 组 的 类 名 


要 让 控制 占 类 有 效 并 很 容易 被 系统 发 现 ， 最 帅 见 的 做 法 是 让 类 名 市 有 后 级 
Controller， 并 使 该 类 继承 自前 面 提 到 的 Controller 基 类 。 这 意味 着 控制 器 名 Home 
所 对 应 的 类 将 是 HomeController 类 。 如 果 存 在 这 样 的 类 ， 系 统 将 成 功 地 解析 请 求 。 
在 ASPNET Core 之 前 的 ASPNET MVC 版 本 中 ， 系 统 就 是 这 样 工作 的 。 

在 ASPNET Core 中 ， 控 制 器 类 的 命名 空间 并 不 重要 ， 不 过 社区 中 提供 的 许多 
工具 和 示例 一 般 都 将 控制 器 类 放 到 一 个 Controllers 文件 夹 中 。 你 自己 可 以 将 控制 器 
类 放 到 任何 文件 夹 和 任何 命名 空间 中 。 只 要 控制 器 类 的 名 称 带 有 Controller 后 级 ， 
并 有 目 继承 日 Controller 基 类 ， 汶 可 以 被 系统 发 现 . 
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2. 不 带 后 组 的 类 名 


在 ASPNET Core 中 ， 即 使 控制 器 类 没有 Controller 后 级 ， 也 能 够 被 成 功 发 现 。 
但 是 ， 对 于 这 种 情况 ， 有 两 个 警告 。 第 一 个 警告 是 ， 只 有 控制 器 类 继承 目 基 类 
Controller 时 ， 发 现 过 程 才 能 工作 。 第 二 个 警告 是 ， 类 名 必须 与 路 由 分 析 中 的 控制 器 
名 匹配 。 

假如 从 路 由 中 取出 的 控制 器 名 称 为 Home， 那 么 可 以 将 控制 器 类 命名 为 Home， 
并 使 其 继承 目 基 类 Controller。 其 他 名 称 不 能 作为 有 效 的 控制 器 名 称 。 换 句 话说 ， 不 

能 使 用 目 定 义 的 后 级 ， 而 且 控 制 占 类 名 的 基本 部 分 必须 始终 与 路 由 中 的 名 称 匹 配 。 


壮 忆 : 

一 般 来 说 ， 控 制 器 类 直接 继承 自 Controller 基 类 ， 并 从 Controller 基 类 获得 环境 
的 属性 和 功能 。 最 主要 的 是 ， 控 制 器 从 基 类 继承 了 HITP 上 下 文 。 可 以 创建 一 些 自 
定义 中 间 类 ， 让 它们 继承 Controller 基 类 ， 然 后 让 实际 的 、 绑 定 到 URL 的 控制 器 类 
继承 自 这 些 中 是 否 创建 这 些 中 间 类 取决 于 在 应 用 程序 的 具体 需求 下 需要 什么 
程度 的 抽 和 象 。 大 部 分 时 候 ， 这 是 一 个 设计 决策 。 


4.1.3 POCO 控制 钴 


操作 调用 程序 将 HTTP 上 下 文 注入 控制 器 实例 ， 在 控制 器 英 内 运行 的 代码 可 通 
过 HttpContext 属性 万 便 地 访 问 HTTP 上 下 文 。 使 控制 器 类 继承 目 系 统 提 供 的 基 类 可 
免费 获得 所 有 必要 的 管道 设施。 但是， 在 ASPNET Core 中 ， 并 不 是 必须 让 任何 控 
制 器 都 继承 自 一 个 常用 的 基 类 。 在 ASPNET Core 中 ， 控 制 器 类 可 以 是 一 个 善 通 传 
统 C# 对 象 (Plain Old C# Object，POCO)， 其 定义 如 下 所 示 : 


public class PocoController 


{ 


// Write your action methods here 
} 
要 想 使 系统 成 功 地 发 现 POCO 控制 占 ， 要 么 类 名 之 有 Controller 后 级 ， 要 么 用 
Controller 特性 修饰 该 类 。 


[Controllerl 


public class Poco 
{ 

// Write YoUT action methods here 
} 


提供 POCO 控制 费 古 一 种 优化 ， 而 优化 通常 来 日 于 丢弃 一 些 功能 ， 以 减 小 开销 
和 /或 内 存 占用 量 。 不 从 已 知 的 基 类 继承 可 能 会 阻止 一 些 常 用 的 操作 ， 也 可 能 使 这 些 
操作 的 实现 变 得 更 加 元 余 。 下 面 来 看 几 个 场景 。 
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1. 返回 普通 数据 


POCO 控制 器 是 一 个 可 完整 测试 的 普通 C# 类 ， 不 依赖 于 周围 的 ASPNET Core 
环境 。 需 要 注意 的 是 ， 只 有 当 不 依赖 于 周围 的 环境 时 ，POCO 控制 器 才能 产生 良好 
的 效果 。 如 果 任 务 是 创建 一 个 极 简单 的 Web 服务 ,仅仅 能 代表 一 个 固定 的 端点 来 返 
回 数 据 ， 那 么 POCO 控制 器 可 能 是 一 个 不 钻 的 选择 (参见 下 面 的 代码 )。 


public class PocoController 
{ 
public IActionResult Today () 
{ 
return new ContentResuUlt () { Content = DateTime.Now.ToString("ddd, dMMM") }; 


| 
} 
如 和 必须 返 回落 个 文件 的 内 容 ， 无 论 是 现 有 的 文件 还 是 要 在 当时 创建 的 文件 ， 
这 段 代 但 的 效果 都 很 好 。 


2. 返回 HTML 内 容 


通过 ContentResult 的 服务 ， 可 将 普通 HIML 内 容 返 回 浏 响 如。 与 上 和 耐 示 例 
不 同 的 是 , 将 ContentType 属性 设 为 合适 的 MIME 类 型 ， 并 按照 需要 创建 HTML 
字符 串 。 


public class Poco 


{ 
public IActionResult Html () 
{ 
return new ContentResult ()} 
L 
Content = "<hl>Hello</hl>", 
ContentType = “text/html™, 
StatusCode = 200 
}; 
} 
} 


通过 这 种 方式 创建 的 任何 HTML 内 容 都 是 用 算法 创建 的 。 如 果 想 要 连接 到 视图 
引擎 (参见 第 6 章 )， 输 出 从 Razor 模板 得 到 的 HIML， 则 需要 做 更 多 工作 ， 而 且 更 
重要 的 是 ， 必 须 更 熟悉 用 到 的 框架 。 

3. 返回 HTML 视图 

要 访问 处 理 HTML 视图 的 ASPNET 基础 结构 ， 并 不 能 直接 实现 。 在 控制 器 方 
法 内 ， 必 须 返 回 一 个 合适 的 IActionResult 对 象 ( 稍 后 详细 介绍 )， 但 是 能 够 快速 、 有 
效 地 完成 这 个 工作 的 所 有 可 用 的 帮助 程序 方法 都 属于 基 类 , 在 POCO 控制 占 中 是 不 
可 用 的 。 下 面 介绍 一 种 基于 视图 返回 HTML 的 迁 回 方法 。 先 提前 声明 ， 这 段 代 码 中 
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显示 的 大 部 分 项 目 将 在 本 章 后 面 或 者 第 5 章 详细 解释 。 这 个 代码 段 的 主要 目的 是 说 
明 POCO 控制 器 占用 的 内 存 更 小 ， 但 是 缺少 一 些 内 署 的 设施 。 


public IActionResult Index([FromServices| IModelMetadataProvider provider) 
{ 
// Initialize a ViewData dictionary to make data available within the view 
Var Vviewdata = new ViewDataDictionary<MyViewModel> (provider, new 
ModelstateDictionary()); 


// Fill the data model for the view 
viewdata.Model = new MyViewModel() { Title = "Hi1i!™ }; 


// Invoke the view passing data 
return new ViewResult() { ViewData = Vviewdata, ViewName = "index™ }; 


} 


注意 方法 签名 中 那个 额外 的 参数 , 这 是 ASPNET Core 中 常用 ( 且 推 荐 采用 ) 的 一 
种 依赖 注入 。 要 创建 一 个 HTML 视图 , 至 少 需要 引用 外 部 的 IModelMetadataProvider。 
组 日 说 ， 如 采 没 有 外 部 注入 的 依赖 项 ， 能 做 的 并 不 多 。 下 面 这 段 代 码 符 试 简化 上 面 
的 代码 。 

public IActionResult Simple () 

{ 


return new ViewResult() { ViewName = "simple™ 上 上; 


} 


可 以 有 一 个 名 为 Simple 的 Razor 模板 ， 人 返回 的 任何 HTML 都 来 目 该 模板 。 但 
是 ， 无 法 把 目 己 的 数据 传递 给 视图 ， 使 泻 染 逻 辑 变 得 足 够 智能 。 而 且 ， 无 法 访问 任 
何 通 过 表单 或 者 查询 字符 串 提 交 的 数据 。 


注意 : 
第 5 章 将 讨论 ViewResult 类 的 作用 和 和 功能， 以 及 用 于 创建 HTML 视图 的 Razor 


"五 -全 
rr。 


4. 访问 HTTP 上 下 文 


POCO 控制 器 最 大 的 问题 是 没有 HTTP 上 下 文 。 这 意味 着 无 法 检查 传递 的 原始 
数据 ， 包 括 查 询 字 符 串 和 路 由 参数 。 但 是 ， 可 以 获取 HTTP 上 下 文 信息 ， 并 只 在 需 
要 的 地 方 把 它们 添加 到 控制 器 中 。 有 两 种 方法 可 实现 此 目的 。 

第 一 种 方法 是 为 操作 注入 当前 的 上 和 下文。 上 下 文 是 ActionContex 类 的 一 个 实例 ， 
其 中 包含 了 HTTP 上 下 文 和 路 由 的 信息 。 下 面 显示 了 要 做 的 工作 。 


public class PocoController 


{ 
[ActLIonCoenteXt |O 
public ActionContext Context { gqet; set; } 
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在 这 个 例子 中 , 接 下 来 就 可 以 访问 Request 对 象 或 者 RouteData 对 象 了 , 束 好 像 
现在 是 在 一 个 常规 的 非 POCO 控制 器 中 。 下 面 的 代码 可 从 RouteData 集合 中 读 取 控 
制 器 名 称 。 


Var controller = Context.RouteData.Values|["controller™|;} 


太一 种 方法 使 用 了 模型 绑 定 功能 ， 本 和 章 稍 后 将 详细 解释 这 种 功能 。 可 以 把 模型 
绑 定 视 为 将 HITP 上 下 文中 可 用 的 特定 属性 注入 控制 需 方 法 中 。 


public IActionResult Http([FromQOuery|] int pl = 0) 
{ 


return new ContentResult() { Content = pl.Tostring() }; 
} 


通过 使 用 FromQuery 特性 修饰 一 个 方法 参数 , 可 让 系统 尝试 将 参数 名 称 (假设 为 
pl) 匹 配 到 URL 的 查询 字符 串 的 一 个 参数 。 如 果 找 到 匹配 旦 类 型 是 可 转换 的 ， 那 么 
方法 的 参数 将 日 动 接受 传递 的 值 。 类 似 地 , 通过 使 用 FromRoute 或 FromForm 特性 ， 
可 以 访问 RouteData 集合 中 的 数据 或 者 通过 HTML 表单 提交 的 数据 。 


注意 : 

在 ASPNET Core 中 ， 全 局 数据 的 概念 相当 模糊 。 如 果 说 全 局 的 意义 是 指 在 应 
用 程序 的 任何 位 置 都 可 以 全 局 访问 ， 那 么 没有 真正 意义 上 的 全 局 数据 。 如 果 想 让 任 
何 数 据 可 被 全 局 访问 ， 就 必须 显 式 地 传递 该 数据 。 更 确切 地 说 ， 必 须 将 数据 导入 可 
能 使 用 它 的 上 下 文中 。 为 此 ，ASPNET Core 提供 了 内 置 的 依赖 注入 (DD 框架 ， 开 发 
人 员 可 通过 这 个 框架 来 注册 抽象 类 型 (如 接口 ) 及 其 具体 类 型 ， 在 请 求 抽象 类 型 的 引 
用 时 ， 返 回 该 抽象 类 型 的 具体 类 型 实例 的 工作 则 由 框架 来 完成 。 我 们 已 经 看 到 了 这 种 
(第 用 ) 编 程 技巧 的 几 个 例子 。 然 而 ， 到 目前 为 止 ， 所 有 的 示例 都 是 特殊 的 ， 因 为 示例 
中 涉及 的 类 型 都 是 隐 式 注册 的 类 型 。 第 8 章 将 详细 介绍 如 何 为 DI 系统 编写 代码 。 


4.2 控制 器 操作 

对 传 入 请 求 的 URL 进行 路 由 分 析 ， 最 终 的 输出 是 由 要 实例 化 的 控制 器 类 和 要 
在 该 类 上 执行 的 操作 的 名 称 构成 的 一 对 值 。 执 行 控 制 器 类 的 操作 就 是 调用 该 控制 器 
类 的 一 个 公有 方法 。 下 面 看 看 操作 的 名 称 如 何 映射 到 类 方法 。 
4.2.1 将 操作 映射 到 方法 


一 般 规 则 是 , 控制 硕 闪 的 任何 公有 方法 都 是 一 个 具有 相同 名 称 的 公有 操作 。 例 如 ， 
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考虑 这 样 的 一 个 URL: /home/index。 根 据 击 和 面 讨论 过 的 有 关 足 由 的 知识 ， 在 这 个 例 
了 于 中 ， 探 制 占 名 称 是 home， 上 所 以 在 项 目 中 需要 有 一 个 实际 的 类 HomeController。 从 
URL 得 到 的 操作 名 称 为 ndex。 因 此 ，HomeController 类 应 该 公开 一 个 名 为 mdex 的 
公有 方法 。 

有 一 些 额 外 的 参数 可 能 起 到 不 同 的 作用 ， 但 是 这 里 提 到 的 是 将 操作 映射 到 方法 
的 核心 规则 。 


1. 按 名 称 映射 
要 查看 MVC 应 用 程序 模型 中 操作 -方法 映射 的 所 有 方面 ， 考 虑 下 面 这 个 例子 。 


Public class HomeController : Controller 
{ 
// Implicit action name: Index 
Public ActionResult Index{() 
{ 
} 


[NonAct1ionl| 
Public ActionResult About () 
{ 


} 


[ActionName ("About™)] 
public ActionResult LoveGermanshepherds () 
{ 


} 

} 

因为 方法 Index 是 公有 的 ， 和 而 且 没 有 用 任何 特性 修饰 ， 所 以 会 隐 式 绑 定 到 一 个 
同名 的 操作 。 这 是 最 常见 的 场景 只 和 需要 六 加 一 个 公有 方法 ， 其 名 称 束 成 为 可 在 外 
部 使 用 任何 HTTP 动词 调用 的 控制 右上 的 操作 。 

值得 注意 的 是 ， 在 上 面 的 例子 中 ，About 这 个 方法 也 是 一 个 公有 方法 ， 但 是 
NonAction 特性 修饰 了 它 。 这 个 特性 并 不 会 改变 该 方法 在 编译 时 的 可 见 性 ， 但 是 会 
使 该 方法 在 运行 时 对 ASPNET Core 的 路 由 系统 个 可 见 。 可 以 在 应 用 程序 的 服务 占 病 
代码 中 调用 该 方法 , 但 是 它 不 会 绑 定 到 可 从 浏览 器 和 JavaScript 代 但 调用 的 任何 操作 。 

最 后 ， 示 例 类 中 的 第 三 个 公有 方法 的 名 字 很 精致 ， 称 为 LoveGermanShepherds， 
它 市 有 ActionName 特性 。 此 特性 将 该 方法 显 式 绑 定 到 操作 About 上 。 因 此 ,每 次 用 户 
请 求 操 作 About 时 ，LoveGermanShepherds 方法 都 会 运行 。LoveGermanShepherds 这 个 
名 称 只 在 控制 占 类 调用 时 使 用 ， 或 者 在 通过 编程 创建 了 HomeController 类 的 实例 并 
在 开发 人 员 的 代码 中 使 用 该 实例 时 使 用 ， 不 过 后 面 这 种 场景 非 第 少见 。 

到 目前 为 止 ， 我 们 还 没有 考虑 HTTP 动词 的 角色 ， 如 GET 或 POST。 为 请 求 使 
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用 的 HITP 动词 是 态 一 级 方法 -操作 映射 的 基础 。 
2. 按 HTTP 动词 映射 
MVC 应 用 程序 模型 十 分 灵活 , 允许 只 针对 攻 个 特定 的 HTTP 动词 将 方法 绑 定 到 操 
作 。 要 将 一 个 控制 器 方法 与 菏 个 HTTP 动 词 关联 起 来 , 可 以 使 用 参数 化 的 AcceptVerbs 
特性 ， 也 可 以 使 用 直接 特性 ， 如 HttpGet、HttpPost 和 HttpPut。AcceptVerbs 特性 允 
许 指定 在 执行 给 定 方法 时 必须 使 用 哪个 HTTP 动词 。 考 虑 下 面 这 个 例子 ; 
[AcceptVeTrbs (Post ) ] 
public IActionResult CallMe() 
{ 
Ne 
在 这 段 代码 中 ， 不 能 使 用 GET 请 求 来 调用 CallMe 方法 。AcceptVerbs 特性 接受 
一 个 字符 串 来 代表 HTTP 动词 。 有 效 的 值 为 对 应 于 已 知 的 HTTP 动词 的 字符 串 ， 如 
get、post、put、options、patch、delete 和 head。 可 以 癌 AcceptVerbs 特性 传递 多 个 
字符 串 ， 也 可 在 同一 个 方法 上 多 次 使 用 该 特性 。 
[AcceptVerbs ("get™", "post™)] 
public IActionResult CallMe () 
{ 
使 用 AcceptVerbs 特性 还 是 多 个 单独 的 特性 (如 HttpGet、HttpPost 和 HttpPub 完 
全 是 个 人 喜好 问题 。 下 面 的 代码 与 上 和 面 使 用 AcceptVerbs 的 代码 是 完全 等 效 的 。 

[HttpPost] 

[HttpGetl] 

public IActionResult CallMe() 

{ 

在 Web 上 ， 当 点 击 链接 或 者 在 地 址 栏 中 输入 URL 时 ， 是 在 执行 HTTP GET 命 
。 当 提交 HTML 表单 的 内 容 时 ， 是 在 执行 HITPPOST 命令 。 其 他 HITP 命令 只 
通过 AJAX 以 及 发 送 请 求 给 ASPNET Core 应 用 程序 的 客户 端 代 码 执行 。 

3. 当 不 同 动词 有 帮助 时 

每 次 在 MVC 视图 中 托管 一 个 HIML 表单 时 ， 都 会 过 到 这 个 常见 的 场景 : 需要 
有 一 个 方法 来 泻 染 视图 并 显示 表 蛙 ， 还 需要 一 个 方法 来 处 理 表单 传递 的 值 。 演 染 请 
求 通 第 是 用 GET 发 送 的 ,处理 请 求 通常 是 用 POST 发 送 的 。 如 何在 控制 器 中 处 理 这 
种 情况 ? 


辟 心 
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一 种 选择 是 只 使 用 一 个 方法 来 处 理 请 求 ， 不 管 使 用 的 HITP 动词 是 什么 。 


public IActionResult Edit (Customer customer) 


{ 


Var method = HttpContext .Request .Method; 
switch (method) 
{ 


Case "GET™: 


return View();} 


} 


在 方法 体内 ， 必 须 确 定 用 户 是 想 显 示 表 单 还 是 处 理 传 递 的 值 。 最 好 的 信息 源 是 


HTTP 上 下 文中 的 Request 对 象 的 Method 属性 。 通 过 使 用 动词 特性 ， 可 将 代码 拆 分 
成 独立 的 方法 。 


[HttpGetl] 


public ActionResult Edit (Customer customer) 


{ 

} 

[HttpPost] 

Public ActionResult Edit (Customer customer) 


| 


} 


现在 有 两 个 方法 绑 定 到 了 不 同 的 操作 。 对 于 ASPNET Core 而 言 ， 这 是 可 以 接 


受 的 ， 因 为 ASPNET Core 将 根据 动词 调用 合适 的 方法 。 但 是 ，Microsoft C# 编 译 堆 
不 接受 这 种 设置 ， 它 不 允许 同一 个 类 中 有 两 个 方法 具有 相同 的 名 称 和 签名 。 下 面 重 
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[HttpGetl] 
[ActionName ("edit™)| 
public ActionResult DisplayEditForm(Customer customer) 


{ 
} 
[HttpPost] 


[ActionName ("edit™)| 
public ActionResult SaveEditForm(Customer customer) 


{ 
} 


现在 ,方法 有 了 不 同 的 名 称 ， 但 是 都 绑 定 到 相同 的 操作 ， 尽 管 它们 对 应 于 不 同 


的 HITP 动词 。 
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4.2.2 ”基于 特性 的 路 由 


基于 特性 的 路 由 是 把 控制 堆 方 法 绑 定 到 URL 的 另 一 种 方式 。 其 思想 是 ， 不 是 
在 应 用 程序 局 动 时 显 式 定义 一 个 路 由 表 ， 而 是 用 专用 的 路 由 特性 修饰 控制 项 方法 。 
路 由 特性 将 在 内 部 填写 系统 的 路 由 表 。 


1. Route 特性 


Route 特性 定义 了 URL 模板 ， 用 于 调用 给 定 的 方法 。 可 把 这 个 特性 放 到 控制 器 
类 级 别 或 方法 级 别 。 如 果 在 这 两 个 级 别 都 出 现 了 Route 特性 , 那么 两 个 URL 将 会 连 
接 起 来 。 下 面 是 一 个 例子 。 


[Route ("goto™)]| 
Public class TourController : Controller 
| 
public IActionResult NewYorK () 
{ 
Var action = RoUteData-Values[ actlIon | .ToString(};}; 
return Ok (action),; 


} 


[Route (nmYc ) 

public IActionResult NewYorKCItY ( ) 

{ 
Var action = RouteData.Values["action"] .ToSsString(); 
return Ok(action}); 


} 


[Route ("/ny")] 

public IActionResult BigApple () 

{ 
Var action = RouteData.Values["action"|] .ToSstring'().; 
return Ok(action); 


} 


类 级 别 的 Route 特性 非常 有 侵扰 性 。 假 设 有 一 个 名 为 TourController 的 类 包含 
巡演 的 控制 器 名 称 ， 在 类 级 别 添加 了 Route 特性 后 ， 就 不 能 调用 该 类 的 方法 。 要 
调用 控制 问 类 的 方法 , 只 能 通过 Route 特性 指定 的 模板 。 那 么 , 如何 调用 NewYork 
方法 呢 ? 

这 个 方法 没有 日 己 的 Route 特性 ， 所 以 会 继承 父 模板 。 因 而 ， 要 调用 该 方法 ， 
需要 使 用 的 URL 是 /goto。 注 意 ，/goto/mewyork 会 返回 一 个 404 错误 (URL 未 找到 )。 试 
看 按照 NewYork 的 路 由 模式 ， 添 加 另 一 个 方法 。 

// No [Route] specified explicitly 


public IActionResult Chicago() 
{ 
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Var action = RouteData.Values["action"| .ITosStrInG( 1) 7 
return Ok(action}); 


} 


现在 , 控制 器 类 中 包含 两 个 没有 目 己 的 Route 特性 的 方法 。 这 样 一 来 , 调用 /goto 
就 会 导 玫 二 义 性 ， 如 图 4-1 所 示 。 


二 过 http':localhest58492 虽 Dtey 
各 Internal Server Error Ww 


An unhandled exception occurred while processing the request， 人 


AmbiguousActionException: Multiple actions matched. The following actions 
matched route data and had all constraints satisfied: 


Simple.AllControllers.TourController.NewYork (Simple) 
Simple.AllControllers.TourController.Chicago (Simple) 
SelectBestCandidate 


图 4-1 ” 当 方 法 没有 Route 特性 时 ， 会 叶 致 二 义 操 作 措 毅 


当 探 制 占 方法 有 目 己 的 Route 特性 时 ， 束 能 够 清楚 地 知道 调用 哪个 方法 了 。 指 
定 的 URL 模板 是 调用 这 种 方法 的 唯一 方式 ， 如 果 在 类 级 别 也 指定 了 相同 的 Route 
特性 ， 那 么 两 个 模板 将 连接 起 来 。 例 如 ， 要 调用 NewYorkCity 方法 ， 必 须 调用 
/gotomyc 。 

在 上 例 中 ， 方 法 BigApple 对 应 男 一 种 场景 。 可 以 看 到 ， 在 这 里 ，Route 特性 的 
值 以 一 个 和 斜 线 开头 。 这 表示 此 URL 是 一 个 绝对 路 径 ， 不 会 与 父 模 板 连接 。 因 而 ， 
要 调用 BigApple 方法 ， 必 须 使 用 /ny 这 个 URL。 注 意 ， 以 /或 ~ 开头 的 URL 模板 指 
定 了 绝对 路 径 。 


2. 在 路 由 中 使 用 路 由 参数 


路 由 也 文 持 参数 。 参 数 是 从 HITP 上 下 文 获取 的 目 定 义 值 。 需 要 注意 的 是 ， 如 
条 应 用 程序 中 也 局 用 了 传统 路 由 ， 那 么 可 以 在 路 由 中 使 用 检测 到 的 控制 闫 名 和 操作 
名 。 下 面 重 写 上 一 个 示例 中 的 NewYork 方法 : 
[Route (™/[controllerl/[action]")| 
[ActionName ("ny")]| 
public IActionResult NewYork() 
{ 
Var action = RouteData.Values["action"| .ToSsString(}; 
return Ok(action}); 
} 
虽然 这 个 方法 属于 TourController 类 ,其 根 Route 特性 为 goto, 但 是 由 于 参数 路 
由 和 ActionName 特性 共同 产生 的 效果 , 现在 通过 URL /tour/ny 可 以 调用 该 方法 。 传 
统 路 由 产生 的 作用 是 ,控制 顺和 操作 参数 在 RouteData 集合 中 定义 ， 可 映射 到 参数 。 
ActionName 特性 只 是 将 NewYork 重 命 名 为 ny。 所 以 ， 这 个 URL 才能 工作 。 
下 面 是 另 一 个 很 好 的 例子 ; 
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[Route ("go/to/ [action]")] 
Public class VipTourController : Controller 


{ 
public IActionResult NewYork () 
{ 
Var action = RouteData.vVvalues["action"| .Tostring(); 
return Ok(action),; 
} 
public IActionResult Chicago() 
{ 
Var action = RouteData-Values[ actlIon | .ToSsString(});}; 
return Ok(action); 
} 
} 


现在 ,该 控制 器 中 的 所 有 方法 都 可 通过 /go/to/XXX 形式 的 URL 访问 , 其 中 XXX 
是 操作 方法 的 名 称 ， 如 图 4-2 所 示 。 


全 尾 http:localhost:584927goAtoychicageo 


图 4-2 使 用 路 由 参数 的 路 由 
3. 在 路 由 中 使 用 自 定义 参数 


路 由 也 可 以 使 用 自 定义 参数 ， 也 就 是 通过 URL、 查 询 字 符 串 或 请 求 体 发 送 给 方 
法 的 参数 。 稍 后 将 介绍 一 些 用 来 收集 输入 数据 的 工具 和 技术 。 现 在 ， 我 们 来 考虑 下 
面 这 个 控制 器 方法 ， 它 也 包含 在 前面 看 到 过 的 VipTourController 类 中 。 


[Route ("{days:intly/adaysn") ] 
public IActionResult SanFranciscol(int days) 


{ 
Var action = string.Format("In {0} for {1} aayYys 
RouteData.Values|["action" | .ToString(), 
days); 
return Ok(action}; 
} 


这 个 方法 接受 一 个 名 称 为 days、 类 型 为 整 型 的 参数 , Route 特性 定义 了 参数 days 
的 位 置 (注意 目 定 义 参 数 使 用 了 不 同 的 表示 法 和 合 )， 并 为 其 添加 一 个 类 型 约束 。 因 此 ， 
go/to/sanfrancisco/for4/days 这 个 漂亮 的 URL 能 够 完美 地 工作 ， 如 图 4-3 所 示 。 
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《3 总 http://localhost:-S8492/go/to/sanfrancisco/for/A/davys 


全 lacalhost 


In SanFranclsco for 4 days 


图 4-3 ”使 用 目 定义 参数 的 路 由 


注意 ， 如 果 URL 中 的 days 参数 不 能 转换 为 整 型 ， 束 会 得 到 404 状态 全 ， 因 为 
找 不 到 这 个 URL。 但 是 ， 如 果 去 挥 类 型 约束 ， 只 是 设置 目 定 义 参数 {days}， 那 么 将 
能 够 识别 这 个 URL， 方 法 将 有 机 会 处 理 它 ， 并 且 days 参数 在 内 部 将 获得 其 类 型 的 
天 认 值 。 对 于 整 型 而 吾 ， 默 认 值 为 0。 可 以 试 试 输入 go/to/sanfrancisco/for/some/days 
这 个 URL， 看 看 会 发 生 什么 。 


注意 : 

在 ASPNET Core 中 ， 也 可 以 在 特定 动词 的 特性 中 指定 路 由 信息 ， 如 HttpGet 
和 HttpPost。 这 样 ， 不 必 再 指定 路 由 ， 然 后 指定 动词 特性 ， 而 是 可 以 将 路 由 URL 模 
板 传递 给 动词 特性 。 


4.3 ”实现 操作 方法 


控制 器 操作 方法 具有 怎样 的 签名 由 你 自己 决定 ， 并 没有 任何 约束 。 如 果 你 定义 
的 方法 没有 参数 ， 就 需要 自己 编写 代码 ， 从 请 求 中 获取 代码 需要 的 任何 输入 数据 。 
如 果 在 方法 的 签名 中 添加 了 参数 , ASPNET Core 将 通过 模型 绑 定 器 组 件 提供 自动 参 

本 节 首 先 讨论 如 何在 控制 器 操作 方法 内 手动 获取 输入 数据 。 然 后 ， 我 们 将 介绍 
ASPNET Core 通过 模型 绑 定 器 提供 的 自动 参数 解析 ， 这 是 ASPNET Core 应 用 程序 
中 最 常用 的 方法 。 最 后 ， 我 们 将 介绍 操作 结果 的 构成 。 


4.3.1 基本 数据 获取 
控制 占 操 作 方 法 能 够 访问 HTTP 请 求 传递 的 任何 输入 数据 。 输 入 数据 的 来 源 


有 很 多 种 ， 包 括 表 单数 据 、 碍 询 字 人 符 串 、cookies、 路 由 值 和 提交 的 文件 。 下 面 诗 
细 说 明 。 
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1. 从 Request 对 象 获取 输入 数据 


编写 操作 方法 体 时 ， 可 以 直接 访问 葡 悉 的 Request 对 象 及 其 子 集合 (如 Form、 
Cookies、Query 和 Headers) 提 交 的 任何 输入 数据 。 稍 后 将 看 到 ，ASPNET Core 提供 
了 上 帆 为 值得 注意 的 设施 (如 模型 绑 定 规 )， 可 用 来 使 代码 更 整洁 、 更 精 舍 、 蝎 容易 测 
试 。 但 是 ， 你 并 非 不 可 以 编写 旧式 的 基于 Request 的 代码 ， 如 下 所 示 。 
public ActionResult Echo() 
// Capture data in a manual way from the query string 
var data = Request.Query["today"]; 
return Ok (data); 
} 
Request.Query 字典 包含 从 URL 的 但 询 字符 串 提 取 的 参数 及 其 对 应 值 的 一 个 列 
表 。 注 意 ， 在 搜索 匹配 项 时 ， 不 考虑 大 小 与 。 
虽然 这 种 方法 可 以 工作 ， 但 是 有 两 个 大 问题 。 首 先 ， 必 须知 道 在 什么 地 方 获 取 
值 ， 是 查询 字符 串 、 提 交 值 列表 、URL 还 是 其 他 地 方 。 必 须 为 不 同 的 来 源 使 用 不 同 
的 API。 其 次 ， 获 取 的 任何 值 都 被 编码 为 字符 串 ， 你 必须 目 己 进行 类 型 转换 。 


2. 从 路 由 获取 输入 数据 


使 用 传统 路 由 时 ， 可 以 在 URL 模板 中 插入 参数 。 这 些 值 将 被 路 由 模板 捕捉 到 ， 
并 可 被 应 用 程序 使 用 。 但 是 ， 路 由 值 并 不 是 通过 从 Controller 继承 的 Request 属性 公 
开 给 应 用 程序 的 。 必 须 使 用 一 种 和 微 不 同 的 方法 ， 通 过 代码 获取 这 些 值 。 假 设 应 用 
程序 局 动 时 注册 了 下 向 的 路 由 。 
routes .MapRoute | 
name: "demo™, 
template: "go/to/{city}/for/{days}/days", 
defaults: new { controller = "Input", action = "Go™ |} 
); 
这 个 路 由 有 两 个 目 定 义 参数 : city 和 days。 探 制 磊 和 方法 的 名 称 是 通过 defaults 
属性 静态 设置 的 。 如 何在 代码 中 获取 city 和 days 的 值 呢 ? 
public ActionResult Go () 
{ 
// Capture data in a manual way from the URL template 
Var city = RouteData.Values["city"]|; 
Var days = RouteData.Values["days"|; 


return Ok({string.Format ( In {0} for {1l1} days", city, days) ); 
} 


路 由 数据 是 通过 Controller 类 的 RouteData 属性 公开 的 。 而 且 , 这 里 采用 不 区 邦 
大 小 写 的 方式 来 搜索 匹配 项 。RouteData.values 字典 是 一 个 String/Object 字典 。 需 要 
目 己 进行 任何 必要 的 类 型 转换 。 
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4.3.2 ”模型 绑 定 


使 用 输入 数据 的 原生 请 求 集合 是 可 以 工作 的 ， 但 是 从 可 读 性 和 可 维护 性 的 角度 
来 看 ， 更 好 的 方法 是 使 用 专门 的 模型 来 把 数据 公开 给 控制 器 。 这 种 模型 有 时 被 称 为 
输入 模型 。ASPNET MVC 提供 了 一 个 目 动 绑 定 层 ， 使 用 内 置 的 规则 集 将 来 目 各 种 
值 提 供 程 序 的 原始 请 求 数据 映射 到 和 输入 模型 类 的 属性 。 作 为 开发 人 员 ， 主 要 负责 输 
入 模型 类 的 设计 。 


= = 后 各 
自 这 


大 多 数 时 候 ， 模 型 线 定 层 内 置 的 映射 规则 足够 让 控制 器 收 到 整洁 的 可 用 数据 。 
但 是 ， 绑 定 层 的 还 辑 在 很 大 程度 上 是 可 定制 的 ， 就 处 理 输入 数据 而 言 ， 这 就 提供 了 
前 所 未 有 的 只 活性 ， 


1. 默认 的 模型 绑 定 器 


任何 传 入 的 请 求 都 会 经过 内 置 的 绑 定 器 对 象 ， 它 对 应 于 DefaultModelBinder 
关 的 一 个 实例 。 模 型 绑 定 由 操作 调用 程序 负责 协调 ， 其 作用 是 检查 选 定 控制 器 方 
法 的 签名 ， 并 合 看 形式 参数 的 名 称 和 类 型 ， 试 图 在 请 求 ( 通 过 三 询 字符 串 、 表 单 、 
路 由 甚或 cookies) 上 传 的 任何 数据 中 找到 匹配 的 名 称 。 模型 绑 定 器 使 用 传统 的 逻辑 
将 提交 值 的 名 称 匹 配 到 控制 问 方 法 的 参数 名 称 。DefaultModelBinder 类 知道 如 何 处 
理 基 本 闫 型 和 复杂 类 型 ， 以 及 集合 和 有 字典。 因此， 默认 绑 定 堪 在 大 部 分 时 候 的 效 
末 不 铬 。 


2. 绑 定 基本 类 型 


减 然 ， 杭 型 绑 定 乍 听 起 来 有 些 神 苛 ， 但 是 其 表 后 并 不 存在 什么 魔法 。 极 型 绑 定 
的 一 个 关键 的 事实 是 ， 它 允许 只 天 注 想 让 控制 占 方 法 收 到 的 数据 ， 而 完全 忽略 其 他 
细 攻 ， 如 怎么 获取 该 数据 ， 以 及 该 数据 是 来 目 租 询 字 符 串 、 请 求 体 偿 是 路 由 。 


/重要 / 
模型 绑 定 器 按 精 确 的 顺序 将 参数 与 传 入 的 数据 匹配 起 来 。 它 首先 检查 是 否 能 够 
在 路 由 参数 上 找到 匹配 ， 然 后 检查 表单 提交 的 数据 ， 最 后 检查 查询 字符 串 数 据 。 
假设 需要 让 某 个 控制 器 方法 重复 给 定 的 字符 串 给 定 的 次 数 。 需 要 的 输入 数据 为 
一 个 字符 串 和 一 个 数字 ， 代 码 如 下 所 示 。 


PubLIC class BindingController : Controller 


{ 


Public IActionResult Repeat (string text, int number) 
1 
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} 

} 

采用 这 种 设计 时 ， 就 不 需要 访问 HTTP 上 下 文 来 获取 数据 。 默 认 的 模型 绑 定 器 
会 从 请 求 上 下 文 的 可 用 的 值 集合 中 读 取 text 和 number 的 实际 值 。 绑 定 器 会 寻找 可 
行 的 值 ， 笑 试 将 形式 参数 的 名 称 (在 本 例 中 为 text 和 numbenD 与 在 请 求 上 下 文中 找到 
的 命名 值 相 匹 配 。 换 句 话 说 ， 如 采 请 求 中 有 一 个 名 为 text 的 表单 字段 、 碍 询 字 人 符 串 
字段 或 者 路 由 参数 ， 那 么 它 的 值 将 自动 绑 定 到 text 参数 。 如 果 参 数 类 型 和 实际 的 什 
是 莱 容 的 ， 映 喘 束 会 成 功 。 如 采 不 能 进行 转换 ， 将 抛 出 一 个 参数 卉 弟 。 例 如 ， 下 面 
的 URLIL 没有 问题 : 

/binding/repeat?text=Dino&number=2 

反 过 来 ， 下 面 的 URL 可 能 产生 无 效 的 结果 : 

/binding/repeat?text=Dino&tnumber=true 


但 询 宁 人 符 串 字 段 text 包含 Dino, 可 以 成 功 地 映射 到 Repeat 方法 的 string 参 类 
万 一 方面 ， 香 询 字 符 串 字段 number 包含 tue， 无 法 成 功 了 映射 到 一 个 int 参数 。 模 型 绑 
定 器 返回 一 个 参数 字典 ， 其 中 对 应 于 number 的 项 包含 该 类 型 的 默认 值 ， 即 0。 上 有 具体 
发 生 什么 要 取决 于 处 理 输入 的 代码 。 代 码 可 以 返回 一 些 宇内 容 ， 其 全 抛 出 一 个 寞 弟 。 

默认 绑 定 器 能 够 映射 所 有 的 基本 类 型 ， 如 string、int、double、decimal、bool 
和 DateTime， 以 及 这 些 类 型 的 相关 集合 。 要 在 URL 中 表达 Boolean 类 型 ， 需 要 用 
到 true 和 false 字符 串 。 这 些 字 人 符 串 是 使 用 .NET Framework 的 原生 Boolean 解析 也 
数 来 解析 的 ， 这 些 函 数 能 够 识别 tue 和 false 字符 串 ， 并 且 不 区 分 大 小 写 。 如 果 使 用 
yes/no 或 其 他 字符 串 代 表 布 尔 值 ， 则 轩 认 绑 定 右 不 能 理解 你 的 目的 ， 将 在 参数 字典 
中 添加 false 值 ， 这 可 能 会 影响 实际 的 输出 。 


3. 强制 从 给 定 来 源 绑 定 


在 ASPNET Core 中 ， 通 过 强制 特定 的 参数 使 用 东 个 数据 源 ， 可 以 改变 模型 绑 
定数 据 源 的 固定 顺序 。 为 此 ， 可 以 使 用 下 面 的 任意 一 个 新 特性 : FromQuery、 
FromRoute 和 FromForm。 顾 名 思 义 ,这些 特性 分 别 强制 模型 绑 定 层 映 射 得 询 字 人 符 串 、 
路 由 数据 和 提交 数据 的 值 。 考 虑 下 面 的 控制 器 代码 。 

[Route ("goto/ {city}")] 


Public IActionResult Visit([FromQuery| string city) 
| 


} 


FromQuery 特性 强制 将 参数 代 但 绑 定 到 答 询 字符 串 中 的 匹配 名 称 。 假 设 请 求 的 
URL 是 /gotofrome?city=london。 你 要 去 哪 呢 ? 罗马 还 是 伦敦 ? 值 Rome 通过 优先 级 
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更 高 的 字典 传递 ， 但 是 实际 的 方法 参数 被 绑 定 到 通过 和 奏 询 字符 串 传 递 的 任何 值 。 因 
此 ，city 参数 的 值 为 London。 需 要 注意 的 是 ， 如 果 强 制 使 用 的 数据 源 不 包含 匹配 的 
值 ， 那么 参数 将 使 用 声明 类 型 的 黑 认 值 ， 而 不 是 其 他 任何 可 用 的 匹配 值 。 换 句 话 说 ， 
FromQuery、FromRoute 和 FromForm 特性 的 效果 是 将 模型 绑 定 限制 到 指定 的 数据 源 。 


4. 从 头 绑 定 


在 ASPNET Core 中 ， 有 一 个 新 的 特性 用 于 简化 在 控制 恬 方 法 中 获取 HITP 头 
中 存储 的 信息 的 工作 。 这 个 新 特性 就 是 FromHeader。 你 可 能 会 想 ， 为 什么 没有 把 
HTTP 头目 动 交 给 模型 绑 定 处 理 。 这 有 两 个 考虑 因素 。 在 我 看 来 ， 第 一 个 因素 更 接 
近 哲 学 而 不 是 技术 。HTTP 头 可 能 不 会 被 视 为 普通 的 用 户 输入 ， 而 模型 绑 定 只 是 被 
设计 为 将 用 户 得 入 映射 到 控制 器 方法 。 在 茶 些 场景 中 ， 在 控制 并 内 检 栓 HITP 头 扒 
市 的 信息 可 能 很 有 帮助 ， 最 突出 的 例 季 是 身份 验证 令 牌 ， 但 是 妃 一 方面 ， 喘 份 验证 
令 脾 并 不 是 严格 的 “用 户 输入 ”不 让 模型 绑 定 器 目 动 解析 HTTP 头 的 第 二 个 因素 
完全 是 技术 因素 ， 与 HITP 头 的 命名 约定 有 关 。 

例如 ， 有 映射 Accept-Language 这 样 的 头 名 称 需 要 有 相应 命名 的 参数 ， 但 是 在 C# 
变量 名 称 中 不 允许 使 用 短 横 线 。FromHeader 特性 解决 了 这 个 问题 。 


public IActionResult Culture([FromHeader (Name ="Accept—Language")|] string language) 
{ 


， 

这 个 特性 接受 头 名 称 作为 参数 ， 将 其 值 绑 定 到 方法 参数 。 上 面 代 但 的 效果 是 ， 
方法 的 language 参数 将 收 到 Accept-Language 头 的 当前 值 。 

5. 从 请 求 体 绑 定 

有 时， 可 以 不 通过 URL 或 头 传递 请 求 数 据 ， 而 是 让 请 求 数 据 作为 请 求 体 。 为 
了 使 控制 器 方法 能 够 接受 请 求 体 的 内 容 ， 必 须 明 确 告诉 模型 绑 定 层 将 请 求 体 的 内 容 
解析 为 特定 的 参数 。 这 就 是 新 特性 FromBody 的 工作 。 你 要 做 的 就 是 像 下 面 这 样 ， 
用 该 特性 修饰 参数 方法 。 


public IActionResult Print([FromBody| string content) 
{ 


} 


请 求 (GET 或 POSDI) 的 完整 内 容 将 作为 一 个 单元 处 理 ， 并 在 合适 的 地 方 映射 到 
通过 (可 能 存在 的 ) 类 型 约束 的 参数 。 


6. 绑 定 复杂 类 型 


对 于 可 在 方法 签名 中 列 出 的 参数 的 数量 并 不 存在 限制 。 但 古 ， 使 用 一 个 容 费 类 各 
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笛 比 长 长 的 参数 列表 更 好 。 对 于 默认 的 模型 绑 定 侨 ， 便 用 参数 列表 还 是 一 个 复杂 尖 型 
的 参数 , 效 打 几乎 是 相同 的 。 这 两 种 场景 都 得 到 了 完整 的 文 持 。 下 面 给 出 了 一 个 例子 : 


public class ComplexController : Controller 
{ 


public ActionResult Repeat (RepeatText linput) 
{ 


} 


} 

控制 器 方法 收 到 一 个 RepeatText 类 型 的 对 象 。 该 普通 的 数据 传输 对 象 ， 
其 定义 如 下 所 示 。 

public class RepeatText 

{ 


public string Text { get; set; } 
Public int Number { get; set; 上 } 
} 
可 以 看 到 ， 该 类 包含 的 成 员 只 是 在 量 一 个 例子 中 作为 单独 参数 传递 的 值 。 就 像 
处 理 单 个 值 一 A 模型 绑 定 器 可 以 很 好 地 处 理 这 个 复杂 的 类 型 。 
对 于 声明 类 型 一 在 本 例 中 为 RepeatText 一 一 的 每 个 公有 属性 ， 模 型 绑 定 占 会 
寻找 键 名 称 与 属性 名 称 匹 配 的 提交 值 。 这 种 匹配 是 不 区 分 大 小 写 的 。 


7. 绑 定 基本 类 型 的 数组 


如 果 控 制 器 方法 期 竺 的 参数 是 一 个 数组 ， 该 怎么 办 ? 例如 ， 能 够 把 提交 表单 的 
内 容 绑 定 到 一 个 IList<T> 参 数 吗 ? 通过 DefaultModelBinder 类 可 以 做 到 这 一 点 ， 但 
是 需要 你 目 己 的 一 些 精心 议 计 ( 参 见 图 4-4)。 


号 DEMDS 


Your Emalls 


EMAIL #1 


one 必 fake-server.com 


EMAIL #2 


EMAIL #3 


three(@fake-server.com 


SAVE 


图 4-4 “提交 一 个 邮件 字符 串 数组 的 示例 视图 
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当 用 户 单 击 按钮 时 ， 表单 会 及 送 各 个 文本 框 的 内 容 。 如 果 每 个 文本 框 有 唯一 的 名 
称 ， 那 么 只 能 通过 名 称 获 取 各 个 值 。 但是， 如 由 恰当 地 对 文本 框 进行 命名 ， 束 可 以 利 
用 绑 定 器 构造 数组 的 能 力 。 使 用 下 面 的 HIML 来 创建 表单 ， 提 交 多 条 相关 的 信息 。 
<input name="emails" id="emaill™" type="text"> 


<input name="emails" id="email2" type="text"> 
<input name~="emalls"”" id="email3" type="text"> 


可 以 看 到 ， 每 个 输入 字段 都 有 一 个 唯一 DD， 但 是 name 特性 的 值 是 相同 的 。 浏 
鸣 胡 发送 的 信息 如 下 所 示 : 


emails=onelfake—-server.comtemails=~&emails~=threelfake—server .com 


有 三 个 元 系 具 有 相同 的 名 称 ， 模 型 绑 定 带 将 目 动 把 它们 分 组 到 一 个 可 枚 举 的 集 
合 中 ， 如 图 4-5 所 未。 


public IActionResult Email(IlList<string> emails) 


{ 


A = "oneDfake-server.com" 
mull 


[| 
A = "three@fake-server.com" | 
起 


图 4-5 ”提交 了 一 个 子 符 串 数组 


最 后 ， 为 了 确保 将 值 的 集合 传递 给 控制 右 方 法 ， 需 要 你 证 上 传 了 共有 相同 名 称 
的 元 素 。 之 后 ， 这 个 名 称 必 须 按 照 绑 定 亏 的 标准 规则 映射 到 控制 右 方 法 的 签名 。 


8. 控制 绑 定 名 称 


对 和 输入 字段 使 用 怎样 的 名 称 是 一 个 有 趣 的 问题 。 在 上 面 的 代码 段 中 ， 所 有 输入 
字段 都 被 命名 为 emails。 这 是 一 个 复数 形式 ， 在 控制 器 端 使 用 很 合适 ， 因 为 在 这 里 
期 望 收 到 的 是 一 个 字符 串 数组 。 但 是 ,在 HTML 端 ， 却 是 在 用 一 个 复数 名 称 命名 单 
个 了 字段。 问题 并 不 在 于 能 不 能 这 么 做 ， 而 是 要 用 现实 世界 中 的 名 称 进行 命名 。 
ASPNET Core 提供 了 Bind 特性 来 解决 这 个 问题 。 

<linput name="emalil”" id="emalill™ type="text"> 


<input name="email™” lid~="email2™" type="text"> 
<input name="emalil™" lid="email3" type="text"> 


在 HIML 源 代码 中 使 用 单数 形式 , 而 在 控制 吉 代 但 中 强制 绑 定 器 将 传 入 的 名 称 
映 味 到 指定 的 参数 。 

public IActionResult Email (|[Bind (Prefix="email™")| IList<string> emalls) 

注意 ，HTML 对 于 JID 名称 中 能 够 使 用 的 字符 有 严格 要 求 。 例 如 ， 赋 给 ID 特性 
的 值 不 能 包含 方 括号 。 但 是 ， 对 于 name 特性 ， 则 没有 这 些 限制 。 在 绑 定 复杂 类 型 
的 数组 时 ， 这 一 点 很 方便 。 
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9. 绑 定 复杂 类 型 的 效 组 


假设 HTML 表单 收集 多 条 聚合 信息 ， 例 如 地 址 。 在 现实 应 用 中 ， 可 能 像 下 面 这 
样 定义 地 址 ; 


public class Address 


{ 
public string Street { get; Set 上 
public string City { get; set; } 
Public string Country { getr set; |} 
} 


而 且 ， 地 址 可 能 是 更 大 的 数据 结构 (如 Company) 的 一 部 分 : 


public class Company 
{ 
public int CompanyId { oqet; set; 上 } 
public IList<Address> Addresses 1{ get; set; | 


} 

假设 输入 表单 与 Company 类 的 结构 匹配 。 提交 表单 时 , 服务 器 会 收 到 一 个 地 址 
集合 。 模 型 绑 定 怎么 处 理 这 个 集合 呢 ? 这 也 与 你 如 何 定义 HTML 标记 有 关 。 对 于 复 
杂 类 型 ， 还 必须 在 标记 中 显 式 创建 数组 。 

<input type="textn id="..." name="company.aAddqresses[0] .Street"” ... /> 


<input type="text™ id="...™ name="company.Addresses[0] .City™ ... /> 
<input type="text"™ id="..."™ name="company.Addresses[1] .Street™ ... /> 


<input type="text"™" id="..." name~="company.Addresses[1] .City™ ... /> 
上 面 的 HIML 结构 将 匹配 到 下 面 的 控制 器 方法 签名 
Public IActionResult Save (Company company) 


绑 定 的 对 象 是 Company 类 的 一 个 实例 ， 其 中 的 Addresses 集合 属性 包含 两 个 元 
和 对。 这 种 方法 很 优雅 ， 也 能 够 工作 ， 但 还 不 够 完美 。 

特别 是 ， 如 果 知 道 集合 中 有 多 少 项 ， 那 么 这 种 方法 的 效果 很 好 ， 但 是 如 果 不 知 
道 ， 这 种 方法 就 可 能 失败 。 男 外 ， 如 果 提 交 值 中 的 索引 序列 不 连续 ， 绑 定 就 会 失败 。 
索引 通 第 从 0 开始 ， 但 是 无 论 索 引 从 什么 地 方 开 始 ， 在 第 一 个 缺少 的 索引 那里 ， 集 
合 会 被 截断 。 人 例如， 如果 address[0] 之 后 是 address[21] 和 address[3]， 那 么 只 有 第 一 项 
会 被 自动 传递 给 控制 器 方法 。 


r 
f 下 
重 有 / 
[| | 


这 里 的 “缺少 信息 ”的 概念 指 的 仅仅 是 模型 绑 定 器 识别 并 处 理 的 数据 。 浏览 器 会 
正确 地 提交 HTML 表单 中 输入 的 全 部 数据 。 但 是 ， 如 果 没 有 模型 绑 定 ， 就 必须 自己 
准备 一 个 相当 复杂 的 解析 算法 来 获取 所 有 提交 的 数据 ， 并 让 这 些 数据 彼此 关联 起 来 。 
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4.3.3 ”操作 结果 


操作 方法 能 够 产生 多 种 结果 。 例 如 ， 操 作 方 法 可 以 仅 作 为 Web 服务 ， 人 返回 一 个 
普通 的 字符 串 或 JSON 字符 串 作 为 请 求 的 啊 应 。 类 似 地 ， 操 作 方 法 可 能 认为 不 需要 
返回 任何 内 容 ， 或 者 需要 各 定 问 到 男 一 个 URL。 操 作 方 法 通常 返回 一 个 实现 了 
IActionResult 的 类 型 的 实例 。 

类 型 [ActionResult 是 一 个 常用 的 编程 接口 ， 用 于 代表 操作 方法 来 执行 一 些 进 一 
步 的 操作 。 上 所 有 这 些 操作 都 与 为 发 出 请 求 的 浏览 需 生 成 一 些 啊 应 有 天 。 


1. 预定 义 的 操作 结果 类 型 


ASPNET Core 提供 了 多 种 实现 了 IActionResult 接口 的 具体 类 型 。 表 4-1 列 出 了 
其 中 的 一 些 类 型 。 表 中 不 包含 与 安全 性 和 Web API 有 关 的 操作 结果 类 型 。 


ContentResult 


EmptyResult 


FileContentResult 


FileStreamResult 


LocalRedirectResult 


JsonResult 


NotFoundResult 


Partial ViewResult 


PhysicalFileResult 


RedirectResult 


RedirectToActionResult 


表 4-1 一 些 预定 义 的 IActionResult 类 型 


将 原始 文本 内 容 ( 不 一 定 是 HIMD) 发 送 给 浏览 器 

不 友 太 内 容 给 济 贤 癌 

将 一 个 文件 的 内 容 发 送 给 浏览 器 。 文 件 的 内 容 被 表示 为 一 个 字 节 
数组 

将 一 个 文件 的 内 容 发 送 给 浏览 器 。 文件 的 内 容 被 表示 为 一 个 Stream 
对 象 

将 HTTP 302 啊 应 代码 发 送 给 浏览 器 ， 以 便 将 浏览 器 重 定 癌 到 当前 
网 站 内 的 指定 URL。 只 接受 相对 URL 

将 一 个 JSON 字符 串 发 送 给 浏览 器 。 此 类 的 ExecuteResult 方法 将 内 
容 类 型 设 为 JSON, 并 调用 JavaScript 序列 化 程序 来 把 任何 收 到 的 托 
党 对 象 厅 列 化 为 JSON 

返回 404 状态 码 

将 HTML 内 容 友 送 给 浏览 项 ， 代 表 整 个 页 面 视图 的 一 个 卢 段 

将 一 个 文件 的 内 容 发 送 给 浏览 器 。 这 个 文件 由 其 路 径 和 内 容 类 型 
标识 

将 HITP 302 啊 应 代码 发 送 给 浏览 器 ， 以 便 将 浏览 器 重 定 回 到 指定 
与 RedirectResult 类 似 ， 将 HTTP 302 代码 和 要 导航 到 的 新 URL 发 
送 给 浏览 器 。 基 于 操作 /控制 器 对 构造 URL 


RedirectToRouteResult 


StatusCodeResult 
ViewComponentResult 
ViewResult 
VirtualFileResult 
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与 RedirectResult 类 似 ， 将 HITP 302 代 公 和 要 导航 到 的 新 URL 发 
送 给 浏 贤 副 。 基 于 路 由 名 称 构造 URL 

返回 指定 的 状态 公 

将 取 目 一 个 视图 组 件 的 HIML 内 容 发 送 给 浏览 砷 

将 代表 一 个 完整 页 和 面 视图 的 HTML 内 容 发 送 给 浏览 毅 

将 一 个 文件 的 内 容 友 送 给 浏览 器 。 这 个 文件 由 其 虚拟 路 径 标识 


如 果 想 通过 下 载 文件 内 容 甚或 表示 为 字 节 数组 的 一 些 普通 的 二 进 制 内 容 来 响应 
请 求 ， 可 以 使 用 与 文件 相关 的 操作 结果 类 。 


si = 


ASPNET Core 不 支持 以 前 版 本 的 ASPNET MVC 中 可 用 的 JavaScriptResult 和 


FilePathResult 操作 结 


采 关 型 。FilePathResult 已 被 拆 分 成 PhysicalFileResult 和 


VirtualFileResult. 要 返回 JavaScript, 现在 需要 使 用 ContentResult 并 提供 合适 的 MIME 
类 型 。 另 外，HttpStatusCodeResult、HttpNotFoundResult 和 HttpUnauthorizedResult 
不 再 可 用 。 但 是 ， 它 们 只 是 被 分 别 重 命名 为 StatusCodeResult、NotFoundResult 和 


UnauthorizedResult, 


2. 安全 性 操作 结 琳 


ASPNET Core 所 供 了 一 些 专 门 用 于 安全 性 操作 一 一 如 身份 验证 和 授权 


的 


操作 结果 类 型 。 表 4-2 总 结 了 这 些 操作 结果 类 型 。 


ChallengeResult 


ForbidResult 


SienInResult 


SienOutResult 


UnauthonzedResult 


表 4-2 安全 性 相关 的 IActionResult 类 型 
描述 

返回 401 状态 但 (未 授权 )， 并 重 定 癌 到 配置 好 的 拒绝 访问 路 径 。 返 
回 此 类 型 的 一 个 实例 与 显 式 调用 框架 的 质询 方法 具有 相同 的 效果 
返回 403 状态 但 (已 蔡 止 )， 并 重 定 癌 到 配置 的 拒绝 访问 路 径 。 返 回 此 
类 型 的 实例 与 显 式 调用 框架 的 禁止 方法 具有 相同 的 效果 
登录 用 户 。 返 回 此 类 型 的 实例 与 显 式 调用 框架 的 登录 方法 具有 相同 的 
效果 
注销 用 户 。 返 回 此 类 型 的 实例 与 显 式 调用 框架 的 注销 方法 具有 相同 的 
效果 
仅 返 回 401 状态 公 ( 未 授权 )， 没 有 任何 进一步 操作 
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瓯 登录 过 程 而 言 ， 从 控制 问 方 法 返回 SignInResult 对 象 与 显 式 调用 新 的 号 份 验 
证 API( 参 见 第 8 草 ) 的 方法 来 登录 用 户 ， 效 来 是 相同 的 。 如 条 是 在 控制 右 方 法 调用 
内 部 (如 登录 表 蛙 后 的 提交 方法 中 )， 那 么 从 设计 角度 看 ， 通 过 操作 结果 创建 一 个 主 
体 对 象 可 能 更 加 整洁 。 但 是 ， 我 认为 选择 哪 种 方法 主要 是 个 人 于 好 。 


3. Web API 操作 结果 


ASPNET Core 中 的 操作 结果 类 型 也 包括 专 为 Web API 框架 创建 的 一 些 类 型 ,在 
之 前 的 版 本 中 ， 它 们 并 不 是 ASPNET MVC 框架 的 一 部 分 。 表 4-3 列举 了 专门 用 于 
Web API 的 操作 结果 类 型 。 


表 4-3 与 Web API 相关 的 IActionResult 类 型 


类 型 描述 

AcceptedResult 返回 202 状态 码 ， 并 返回 URI 来 监控 请 来 的 状态 

AcceptedAtActionResult 返回 202 状态 但 , 并 返回 URI 来 监控 请 来 的 状态 , 返回 的 URI 
为 一 个 控制 占 / 操 作对 

AcceptedAtRouteResult 返回 202 状态 但 , 并 返回 URI 来 监控 请 求 的 状态 , 返回 的 URI 
为 一 个 路 由 名 称 

BadRequestObjectResult 返回 400 状态 但 ， 作 为 可 选项 ， 还 可 以 在 模型 状态 字典 中 设 
和 置 销 误 

BadRequestResult 返回 400 状态 公 

CreatedResult 返回 201 状态 个 ， 以 及 创建 的 资源 的 URI 

CreatedAtActionResult 返回 201 状态 公 ， 以 及 表示 为 控制 右 / 操 作对 的 资源 URI 

CreatedAtRouteResult 返回 201 状态 个 ， 以 及 表示 为 路 由 名 称 的 资源 URI 

CreatedResult 返回 201 状态 但， 以 及 创建 的 对 象 的 URI 

NoContentResult 返回 204 状态 人 码 和 null 内 容 。 与 EmptyResult 类 似 ， 只 是 
EmptyResult 会 返回 null 内 容 ， 人 设置 状态 伺 200 

OkObjectResult 返回 200 状态 码 ， 并 在 友 列 化 收 到 的 内 容 之 前 进行 内 容 

OkResult 返回 200 状态 码 


UnsupportedMediaTypeResult | 返回 415 状态 码 
在 以 前 版 本 的 ASPNET 中 , Web API 框架 作为 一 个 单独 的 框架 ,用 来 以 纯 REST 


风格 接受 和 处 理 请 求 。 在 ASPNET Core 中 ，Web API 框架 (包括 其 自己 的 控制 器 服 
务 和 操作 结果 类 型 ) 已 被 集成 到 主 框架 中 。 
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4.4 操作 人 病 选 器 
操作 筛选 器 是 围绕 操作 方法 运行 的 一 段 代 码 ， 可 用 于 修改 和 扩展 方法 本 身 的 行为 。 
4.4.1 操作 师 选 器 的 神 析 


下 面 的 接口 完整 表示 了 一 个 操作 炳 选 堆 : 


public interface IActionFilter 
{ 
VOld OnActionExecuting (ActionExecutingContext filterContext); 
Volad OnActionExecuted (ActionExecutedContext filterContext); 
} 
可 以 看 到 ， 它 提供 了 挂钩 ， 供 在 操作 执行 之 醒 和 之 后 运行 代码 。 在 短 选 器 内 ， 
E 人 够 访问 请 求 和 控制 从 上 下 文 ， 并 且 可 以 谈 取 和 修改 参数 。 


1. 操作 径 选 器 的 原生 实现 


每 个 继承 了 Controller 闫 的 、 用 户 定 义 的 控制 项 都 会 获得 IActionFilter 接口 的 默 
认 实 现 。 事 实 上 ， 基 类 Controller 提供 了 一 对 可 重 与 的 方法 : OnActionExecuting 和 
OnActionExecuted。 这 晶 味 看 每 个 控制 并 类 都 提供 了 一 个 机 会 ， 用 来 决定 在 调用 给 
定 方法 之 前 、 之 后 或 者 调用 该 方法 之 六 及 之 后 做 些 什么， 只 需要 重 写 基 关 的 方法 网 
能 实现 这 种 功能 。POCO 控制 器 则 不 具备 这 种 能 力 。 

在 下 面 的 代码 中 ， 每 当 调用 Index 方法 时 ， 会 添加 一 个 专门 的 啊 应 头 。 

public class FilterController : Controller 

{ 


protected DateTime StartTime; 
public override void OnActionExecuting (ActionExecutingContext filterContext) 


{ 
Var action = fijlterContext .ActionDescriptor.RouteValues["action™]; 
if (string.Equals(action, "jndex", StringComparison. 
CurrentCulturelgnoreCase)) 
| 
startTime = DateTime .Now; 
} 
base.OonActionExecuting (filterContext),;} 
} 


public override Vold OnActionExecuted (ActionExecutedContext filterContext) 
{ 
Var action = filterContext .ActionDescriptor.RouteValues["action"™|]; 
if (string.Equals(action, "index", StringComparison. 
CurrentcCculturelgnoreCase)) 
| 


var 七 ImeSpan = DateTime.Now — StartTime; 
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filterCcontext.HttpContext.Response.Headers.Addl 
"duration", timeSpan.TotalMiIlliseconds.ToSstring())}); 


} 
base.onActionExecuted (filterContext),} 


public IActionResult Index () 
{ 


return Ok("Just processed Filter.lIndex"); 
} 
图 4-6 演示 了 该 方法 如 何 计算 自己 执行 了 多 少 毫秒 ， 以 及 如 何 把 这 个 数字 写 入 
一 个 新 的 啊 应 头 duration 中 。 


和合 全 http://localhost:58492 /filter/index 


辣 localhost 


Just processed Filter.Index 


DOM Explorer Console Debugger Network (?) 孜 一 LO 11 Es 其 


本 二 和 宙 六 和 艺 丑 平 - Content type Find (Ctrl+ 月 


ame Headers 。 Body ”Parameters Cookies Timings 
Path Frotoco | h Host: localhost:58492 

index HTTP G 
http://localhost:58492 /filtery 

bootstrap.min.css HTTPS G 
https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/ 


Proxy-Connection: Keep-Alive 
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64;... 


4 Response Headers 
bootstrap.min.css.map HIIP/2 6G 


i a , Content-Encodinag: qzic 
https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/ 村 


Content-Type: text/plain; charset=utf-8 
Date: Thy, 21 Dec 2017 17:57:24 GMT 
duration: 3.9999 
Server: Kestrel 
Transfer-Encoding: chunked 
Vary: Accept-Encoding 
X-Powered-By: ASP.NET 
< > X-SourceFiles: =?UTF-8?B?QzpcRGOVtb3NcQm9valxD... 
0 errors 3 requests 0 B transferred 2.01 s taken (DOMContentLoaded': 730 ms, load: 835 ms) 


图 4-6 ”向 方法 Index 添加 一 个 自 定义 响应 头 


筛选 器 的 分 类 


操作 筛选 器 只 是 ASPNET Core 管道 中 调用 的 一 种 生 选 器 。 按 照 筛选 器 实际 完 
成 的 任务 ， eareaenl 表 4-4 列 出 了 ASPNET Core 的 管道 中 可 发 挥 
作用 的 电 选 器 类 型 。 
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表 4-4 ASP.NET Core 管 这 中 的 策 选 器 类 型 


类 型 描述 

授权 筛选 器 管道 中 运行 的 第 一 类 筛选 器 ， 用 来 确定 发 出 请 求 的 用 户 是 否 有 权 发 
出 当前 的 请 求 

资源 筛选 器 当 授权 之 后 ， 在 管道 的 其 余部 分 之 前 以 及 管道 组 件 之 后 运行 。 对 于 
缓存 很 有 用 

操作 筛选 器 在 控制 器 方法 操作 之 前 和 之 后 运行 

异常 利 选 器 如 果 注 册 ， 则 在 发 生 未 处 理 异常 时 触发 

结果 筛选 器 在 操作 方法 结果 执行 之 前 和 之 后 运行 


师 选 右 可 以 有 同步 或 者 弄 步 实现 。 使 用 哪 一 种 实现 要 取决 于 个 人 豆 好 和 情况 

ASPNET Core 中 内 置 了 一 些 肾 选 邢 ， 稍 后 将 看 到 ， 还 可 以 针对 特定 的 目的 创建 
更 多 的 师 选 部 。 在 内 置 晴 选 锅 中 , 我 要 强调 以 下 几 个 : RequireHttps 强制 通过 HTTPS 
调用 控制 器 方法 ValidateAntiForgeryToken 可 检查 通过 HTML 提交 发 送 的 令 脾 ， 以 
预防 偷偷 措 近 的 攻击 ; Authorize 使 得 控制 占 的 方法 只 能 被 通过 验证 的 用 户 使 用 。 

3. 往 选 器 的 可 见 性 

可 以 将 师 选 器 应 用 到 单独 的 方法 ， 也 可 以 应 用 到 整个 控制 器 类 。 如 果 将 和 负 选 器 
应 用 到 控制 占 类 ， 它 们 将 影响 该 控制 上 公开 的 所 有 操作 方法 。 与 之 相对 ， 在 应 用 程 
订 司 动 时 注册 了 全 局 贤 选 器 之 后 ， 它 们 将 目 动 应 用 到 任何 控制 避 类 的 任何 操作 。 

全 局 贤 选 器 就 是 普通 的 操作 沛 选 占 ， 只 不 过 是 通过 代码 在 应 用 程序 局 动 时 注册 
的 ， 如 下 所 示 。 


Public void ConfigureServices (IServiceCollection services) 


{ 
Services.AddMvc (options 三 > 
{ 
options.Filters.Add (new OneActionFilterAttribute () ) 7 
options.Filters.Add (typeof (AnotherActionFilterAttribute)); 
}})s 
} 


可 按 实 例 或 闫 型 添加 饶 选 堪 。 当 按 关 型 添加 时 ， 将 通过 ASPNET Core 的 DI 框 巢 
来 获取 实际 的 实例 。 首 先 调 用 的 是 全 局 和希 选 眶 ， 其 次 是 在 控制 闫 级 别 定 义 的 中 选 典 ， 
最 后 是 在 操作 方法 上 定义 的 师 选 器 。 注 意 ， 如 果 控 制 占 类 重 写 了 OnActionExecuting， 
其 代码 将 在 任 晶 方 法 级 中选 占 应 用 之 前 运行 。 如 果 控 制 舌 关 重 与 OnActionExecuted， 
其 代 但 将 在 任意 方法 级 吧 选 问 应 用 之 后 运行 。 
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4.4.2 ”操作 师 选 器 的 小 集合 


总 的 来 看 ， 操 作 筛 选 器 构成 了 ASPNET Core 中 内 置 的 一 个 面向 切面 的 框架 。 
编写 操作 渍 选 右 时 ， 一 般 需 要 继 厌 ActionFilterAttribute， 然 后 添加 目 己 的 行为 。 
接 下 来 介绍 几 个 示例 操作 希 选 器 。 


注意 : 
操作 篇 选 器 是 封装 了 特定 行为 的 自 定义 组 件 。 每 当 想 要 隔离 这 种 行为 并 需要 轻 
松 地 复制 它 时 ， 就 可 以 编写 一 个 操作 筛选 器 。 行 为 的 可 重用 性 是 决定 是 否 编写 操作 
第 选 器 的 因素 之 一 ， 但 不 是 唯一 因素 。 操 作 筛选 器 也 能 使 控制 器 的 代码 保持 精简 有 
效 。 一 般 来 说 ， 每 当 控 制 器 方法 的 代码 中 充斥 着 分 支 和 条 件 语句 时 ， 可 以 停 下 来 思 
考 是 不 是 可 以 把 其 中 的 一 些 分 支 ( 或 重复 代码 ) 移 动 到 一 个 操作 筛选 器 中 。 代 码 的 可 
读 性 将 能 够 得 到 很 大 的 提升 。 
1. 添加 自 定 义 头 
操作 筷 选 器 的 一 个 常见 的 例子 是 为 给 定 操作 方法 的 每 个 请 求 添加 一 个 日 定义 
。 在 本 章 前 向 ， 看 到 了 如 何 通 过 重 写 OnActionExecuted 控制 器 方法 来 实现 这 个 目 
。 下 面 的 代码 显示 了 如 何 将 相关 代码 从 控制 器 中 移出 ， 放 到 一 个 单独 的 类 中 。 


public class HeaderAttribute : ActijonFilterAttribute 
{ 


全 米 


public string Name { get; sets; } 
public string Value { get set; | 


public override void OnActionExecuted(ActionExecutedContext filterContext) 


{ 
if (lstring.IsNullorEmpty (Name) && lstring.IsNullorEmpty (Value)) 
filtercontext .HttpContext .Response.Headers.Add (Name, Value);}; 
return; 


} 

现在 束 有 了 很 容易 管理 的 一 段 人 代码。 可 以 将 其 附加 到 任意 数量 的 控制 器 操作 ， 
附加 到 一 个 控制 占 的 全 部 操作 ， 甚 全 全 局 附加 到 所 有 的 控制 融 。 需 要 做 的 就 是 像 下 
面 这 样 添 加 一 个 特性 : 

[Header (Name="Action"y, Value="About™)| 

public ActionResult About () 

{ 

8 ee 


接 下 来 看 一 个 复杂 一 些 的 示例 ， 其 涉及 了 应 用 程序 视图 的 本 地 化 。 
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2. 设置 请 求 的 区 域 性 


ASPNET Core 提供 了 一 个 完善 的 、 定 制 的 基础 结构 来 文 持 多 语言 应 用 程序 。 在 
以 前 的 任何 版 本 的 ASPNET 中 ,都 不 存在 类 似 的 有 具体 框 染 , 不 过 有 一 些 单独 的 工具 
可 用 来 构建 这 种 框 钠 。 如 果 有 一 个 很 大 的 代码 库 是 遗留 的 ASPNET MVC 代码 ， 那 
么 很 可 能 有 读 取 用 户 首选 的 区 域 性 , 然后 在 每 个 传 入 请 求 上 恢复 这 个 区 域 性 的 逻辑 。 

第 8 草 将 介绍 用 于 处 理 多 个 区 域 性 以 及 在 不 同 区 域 性 间 切 换 的 ASPNET Core 
中 则 件 。 这 里 只 是 演示 如 何 使 用 全 局 操作 师 选 右 重 写 相 同 的 逻辑 。 可 以 看 到 ， 思 想 
是 相同 的 ， 只 不 过 是 在 实现 时 使 用 了 ASPNET Core 中 间 件 ， 在 管道 的 早期 通过 区 
域 性 开关 来 触发 这 些 中 间 件 。 


[AttributeUsage (AttributeTargets.Class|AttributeTargets.Method, AllowMultiple = 
false)l| 

public class CultureAttribute : ActionFilterAttribute 
{ 

public string Name { get; set; |} 

public static string CookieName 

{ 

get 1{ return ™” Culture"; } 


} 


public override void OnActionExecuting (ActionExecutingContext filterContext) 
{ 
Var culture = Name; 
if (string.IsNullorEmpty (culture)) 
culture =GetSavedCultureorDefault (filtercontext.HttpContext.Request); 


// Set culture on current thread 
SetCultureonThread (culture}); 


// Proceed as usual 
base.OnActionExecuting (filterContext),; 
} 


private static string GetSavedCultureorDefault (HttpRequest httpRequest) 
{ 

Var culture = CulturelInfo.CurrentcCulture.Name; 

Var Cookie = httpRequest.Cookies [CookieName| ?3? culture; 

return culture; 


} 


private static void SetCultureonThread (string language) 
{ 
Var cultureInfo = new CulturelInfo(language); 
CultureInfo.Ccurrentculture = culturelIntfo; 
CultureInfo.CcurrentUICulture = cultureIntfo; 


} 


在 执行 操作 方法 之 前 ， 代 码 检 查 一 个 名 为 Culture 的 目 定 义 cookie， 其 中 可 能 
包含 了 用 户 首选 的 语言 。 如 果 没 有 找到 cookie， 筑 选 器 将 默认 使 用 当前 的 区 域 性 ， 
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并 将 其 赋值 给 当前 的 线程 。 为 了 确保 Culture 筛选 器 会 应 用 到 每 个 控制 器 方法 ,需要 
全 局 注册 该 筛选 器 ; 


Public void ConfigqureServices (lIServiceCollection services) 
{ 
Services.AddMvc (coptions 三 > 
{ 
options.Filters.Add (new CultureAttribute ()); 
}); 
} 


is "i 二 
[后 |】 注意 : 
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全 局 注册 的 得 选 器 与 在 类 或 方法 级 别 显 式 赋值 的 筛选 器 没有 区 别 。 编 写 操作 得 
选 器 时 ， 通 过 使 用 AttributeUsage 特性 可 控制 第 选 器 的 作用 域 : 


[AttributeUsage (AttributeTargets.Class|AttributeTargets.Method, AllowMultiple = 
false)l| 


特别 是 ,可 使 用 AttributeTargets 枚 举 指 出 将 该 特性 放 到 哪里 ,使 用 AllowMultiple 
属性 决定 在 同一 个 位 置 能 够 使 用 一 个 特性 多 少 次 。 注意 ，AttributeUsage 特性 可 用 于 
创建 的 任何 自 定义 特性 ， 而 不 只 是 操作 筛选 器 . 


3. 将 方法 限定 为 Ajax 调用 


到 目前 为 止 考虑 的 操作 稍 选 器 是 自在 鹤 获 操作 方法 的 一 些 执行 阶段 的 组 件 。 如 
条 想 添加 一 些 代 码 ， 帮 助 确定 特定 的 方法 是 个 适合 处 理 特 定 的 操作 ， 应 该 怎么 办 ? 
对 于 这 种 关 型 的 目 定 义 ， 需 要 使 用 另外 一 类 猎 选 器 : 操作 选择 堪 。 

操作 选择 并 分 为 两 类: 操作 名 称 选 择 器 和 操作 方法 选择 器 。 名 称 选 择 器 确定 筷 
们 修饰 的 方法 是 合 能 够 用 于 处 理 给 定 的 操作 名 称 。 方 法 选择 堆 确 定名 称 匹 配 的 方法 
是 耕 能 够 用 于 处 理 给 定 的 操作 。 方 法 选择 器 通常 根据 其 他 运行 时 条 件 给 出 啊 应 。 前 
面 使 用 过 系统 提供 的 ActionName 特性 ,这 是 一 个 标准 的 操作 名 称 选择 器 ,NonAction 
和 AcceptVerbs 特性 则 是 操作 方法 选择 如 的 常见 例子 。 下 和 耐看 看 如 何 编 写 一 个 目 定 
义 方法 选择 器 ， 使 得 只 有 通过 JavaScript 发 出 请 求 时 ， 才 接受 方法 调用 。 

这 需要 一 个 继承 日 ActionMethodSelectorAttribute 的 类 ， 并 重 写 IsValidForRequest 
方法 : 


public class AjaxOnlyAttribute : ActionMethodSelectorAttribute 


{ 
Public override bool IsValidForRequest (RouteContext routeContext, 
ActijonDescriptor action) 
{ 
return routeContext.HttpContext.Request.IsAjaxRequest ();} 
} 
} 


IsAjaxRequest 方法 是 HttpRequest 类 的 一 个 扩展 方法 。 
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public static class HttpRequestExtensions 


{ 
public static bool IsAa]axReduest (this HttpRequest request) 
{ 
if (request == null) 
throw new ArgumentNullException("request"™),; 
if (request.Headers I= null) 
return request.Headers["X-—Regquested-—With"|] == "XMLHttpRegquest"}; 
return false; 
} 
} 


使 用 AjaxOnly 特性 标记 的 任何 方法 只 能 用 于 处 理 通过 浏览 器 的 XMLHttpRequest 
对 象 肥 出 的 调用 。 
[&]axoOnTY| 
public ActionResult Details (int customerId) 
{ 
Var model = ...} 
return PartialView (model).; 
} 
如 果 按 照 路 由 设置 ， 攻 个 URL 应 该 映射 到 一 个 只 能 用 于 Ajax 处 理 的 方法 ， 那 
么 当 试图 调用 这 个 URL 时 ， 就 会 得 到 一 个 未 找到 异常 。 


注意 : 
日 相同 的 方法 可 用 于 检查 发 出 请 求 的 客户 端的 用 户 人 代理， 以 及 识别 来 自 移动 设备 
的 调用 。 


4.5 “小结 


控制 器 是 ASPNET Core 应 用 程序 的 核心 ， 在 用 户 请 求 和 服务 器 系统 的 功能 之 
则 起 到 协调 的 作用 。 探 制 右 链接 到 用 户 界 和 耐 操作 ， 并 与 中 间 层 有 联系 。 探 制 占 执行 
操作 以 获得 结果 ， 但 是 不 直接 返回 结果 。 在 控制 器 中 ， 请 求 的 处 理 与 让 请 求 结果 可 
用 的 任何 进一步 操作 (最 明显 的 是 演 染 HIML 视图 ) 被 整洁 地 隅 离开 了 。 

从 设计 的 角度 看 ， 控 制 器 是 表示 层 的 一 部 分 ， 因 为 它们 需要 引用 运行 时 环境 并 
了 解 请 求 的 HITP 上 下 文 。 虽 然 ASPNET Core 引入 并 支持 POCO 控制 器 ， 但 我 更 
经 常 使 用 的 是 非 POCO 控制 器 。 

控制 右 操 作 方 法 能 够 返回 多 种 操作 结果 类 型 ， 如 文件 内 容 、JSON、 纯 文本 和 重 
定 问 啊 应 。 第 5 章 将 介绍 Web 应 用 程序 最 第 见 的 操作 结果 类 型 : HTML 视图 。 


97 


5 


ASP.NET MVC 视图 


根本 不 必 把 他 说 的 一 切 都 当成 是 真 的 ， 只 要 认为 他 的 话 是 必要 的 就 够 了 . 
一 一 缆 兰 效 。 卡 夫 卡 ，《 审 判 》 


大 部 分 ASPNET MVC 请 求 要 求 将 HTML 标记 返回 给 浏览 器 。 从 架构 的 角度 来 
看 ， 返 回 HIML 标记 的 请 求 与 返回 纯 文本 或 JSON 数据 的 请 求 并 没有 区 别 。 但 是 ， 
因为 生成 HTML 标记 有 时 可 能 需要 大 量 工 作 (并 总 是 需要 非常 灵活 的 处 理 )， 所 以 
ASPNET MVC 提供 了 一 个 专门 的 系统 组 件 一 一 视图 引擎 一 一 来 生成 普通 的 HTML， 
共 浏 览 占 处 理 。 在 这 个 过 程 中 ， 视 图 引擎 将 应 用 程序 的 数据 与 一 个 标记 模板 混合 起 
来 ， 创 建 出 HTML 标记 。 

本 章 将 探讨 视图 引擎 的 结构 和 行为 ， 以 及 定制 其 行为 可 到 达 的 程度 。 最 后 ， 我 
们 将 讨论 无 控制 器 页 向 (也 称 为 Razor 贝 而 )， 实 际 上 它们 就 是 下 接 调 用 的 HTML 模 
板 ， 没 有 经 过 控制 器 操作 方法 的 协调 。 


5.1 提供 HTML 内 容 


在 ASPNET Core 中 ， 应 用 程序 能 够 以 多 种 方式 提供 HIML， 各 种 方法 的 复杂 


100 


第 中 部 分 ASPNET MVC 应 用 程序 模型 


5.1.1 从 终止 中 间 件 提供 HTML 


如 第 2 划 所 述 , ASPNET Core 应 用 程序 可 以 仅 古 围绕 一 些 终 止 中 间 件 构建 的 一 
个 非常 瘦 的 Web 服务 顷 。 终 止 中 间 件 是 能 够 处 理 请 求 的 一 段 代 人 码 。 基 本 上 ， 它 束 古 
一 个 处 理 HTTP 请 求 的 函数 。 代 人 码 可 以 做 任何 操作 ， 包 括 返 回 一 个 字符 串 ， 而 浏览 
骼 将 把 它 作 为 HTML 呈现 。 下 向 这 个 示例 Startup 类 即 用 于 此 目的 。 


public class Startup 


{ 
Public void Configure (IApPpPlicationBuilder app) 
{ 
app .Run (async context 三 > 
{ 
Var ob] = new SomeWork (1) 
await context.Response.WriteAsync ("<hl>"™ + obj -Now() + "</hl>"); 
}); 
} 
} 


通过 在 啊 应 的 输出 流 中 写 入 HIML 格式 的 文本 (可 能 还 设置 合适 的 MIME 类 
型 )， 可 以 癌 浏 览 器 提供 HTML 内 容 。 整 个 过 程 很 直观 ， 没 有 和 工 选 器 ， 也 没有 中 间 
协调 。 这 种 方法 可 以 工作 ， 但 是 我 们 没有 得 到 一 个 可 维护 的 、 灵 活 的 解决 方案 。 


5.1.2 ”从 控制 器 提供 HTML 


更 现实 的 情况 是 , ASPNET Core 应 用 程序 使 用 MVC 应 用 程序 模型 和 控制 器 类 。 
如 第 4 章 所 述 ， 所 有 的 请 求 都 会 被 映射 到 控制 问 类 的 某 个 方法 。 选 定 的 方法 将 能 够 
访问 HITP 上 下 文 ， 检 碍 传 入 的 数据 ， 以 及 决定 采取 什么 操作 。 当 方法 收集 到 所 有 
必要 的 数据 后 ， 就 能 够 准备 响应 了 。 我 们 既 可 以 通过 算法 快速 准备 HIML 内 容 ， 也 
可 以 从 选 定 的 HIML 模板 更 加 方便 地 生成 HTML 内 容 ， 模 板 中 的 占 位 符 将 被 奉 换 
为 计算 出 的 数据 。 


1. 在 操作 方法 中 提供 纯 文 本 作为 HTML 


下 面 的 代码 演示 了 一 个 控制 器 方法 模式 ， 该 模式 可 以 通过 某 种 方式 检索 数据 ， 
然后 将 检索 到 的 数据 格式 化 为 菏 种 有 效 的 HIML 布局 。 
public IActionResult Infol(int 1id) 
{ 
Var data = service.GetInfoAsHtml (id); 
return Content (html, "text/html").; 
} 


当 控 制 器 方法 重新 控制 了 执行 流 之 后 ， 会 保存 一 个 文本 字符 串 ， 它 知道 这 个 字 
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符 串 是 由 HIML 标记 构成 的 。 然 后 ， 用 合适 的 HIML MIME 类 型 修饰 文本 之 后 ， 
控制 器 会 返回 这 个 文本 字符 串 。 这 种 方法 只 比 直 接 将 HIML 写 入 输出 流 稍 好 一 些 ， 
因为 它 允 许 通 过 模型 绑 定 将 输入 数据 映射 到 合适 的 .NET 类 型 ,并且 依 赖 于 结构 化 程 
度 更 高 的 代码 。 实 际 生 成 HTML 的 过 程 仍然 是 通过 算法 完成 的 ， 这 人 句 话 的 意思 是 ， 
要 修改 布局 ， 必 须 修 改 代码 ， 之 后 还 需要 编译 代码 。 


2. 从 Razor 模板 提供 HTML 


提供 HTML 内 容 最 第 用 的 方法 是 使 用 模板 文件 来 表达 期 户 的 布局 , 使 用 一 个 独 
立 的 引 黎 来 解析 模板 ， 并 使 用 真实 的 数据 填充 模板 。 在 ASPNET MVC 中 ，Razor 
是 用 来 表达 类 似 HTML 的 模板 的 标记 语言 ， 而 视图 引 黎 是 一 个 系统 组 件 , 将 模板 渔 
染 成 可 使 用 的 HIML。 

public IActionResult Infol(int 1d) 

Var model = service.GetInfol(id); 


return VIew( "template", model);} 


} 


调用 View 函数 将 触发 视图 引擎 ， 返回 一 个 对 象 ， 该 对 象 封装 了 要 使 用 的 Razor 
模板 文件 (一 个 扩展 名 为 .cshtml 的 文件 ) 的 名 称 和 一 个 视图 模型 对 象 ， 后 者 包含 了 要 
在 最 终 的 HTML 布局 中 显示 的 数据 。 

这 种 方法 的 好 处 是 ， 标 记 模板 (这 是 最 终 HTML 页 面 的 基础 ) 与 其 中 将 显示 的 数 
据 被 整洁 地 隔离 开 了 。 视 图 引擎 是 一 个 系统 工具 ， 协 调 着 其 他 组 件 (如 Razor 解析 器 
和 页 面 编译 器 ) 的 活动 。 从 开发 人 员 的 角度 看 , 通过 编辑 Razor 模板 (一 个 类 似 HTML 
的 文件 ) 来 修改 要 返回 给 浏览 器 的 HTML 的 布局 是 可 以 满足 需要 的 。 


5.1.3 从 Razor 页 面 提供 HTML 


在 ASPNET Core 2.0 中 ，Razor 页 面 是 另外 一 种 提供 HTML 内 容 的 方式 。 基 本 
上 ， 就 是 需要 创建 Razor 模板 文件 ， 这 些 文件 可 被 直接 使 用 ， 而 不 需要 通过 控制 器 
或 控制 器 操作 。 只 要 将 Razor 页 面 文件 放 到 Pages 文件 夹 下 ， 并 且 其 相对 路 径 和 名 
称 与 URL 区 配 ， 那 么 视图 引擎 就 能 够 处 理 其 内 容 并 生成 HTML。 

Razor 贝 和 看 与 普通 的 控制 占 驱 动 的 视图 有 一 个 很 大 的 区 别 : Razor 页 面 可 以 是 包 
合 代 但 和 标记 的 一 个 文件 ， 与 ASPX 页面 很 相似 。 如 果 读 者 很 熟悉 MVC 控制 右 ， 
那么 可 能 会 认为 Razor 页 面 没 有 意义 和 用 途 ， 只 能 在 一 些 衬 见 的 场景 中 使 用 ， 例 如 
用 控制 器 方法 渲染 一 个 没有 任何 业务 逻辑 的 视图 时 。 如 果 是 新 接触 MVC 应 用 程序 
模型 ， 那 么 Razor 页面 的 门槛 较 低 ， 可 以 很 容易 上 手 这 个 框架 。 
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注意 : 

有 关 Razor 页 面 的 一 个 奇怪 的 地 方 是 ,只 要 视图 只 比 静 态 HTML 文件 复杂 一 点 ， 
使 用 它们 就 很 合适 。 不 过 ，Razor 页 面 也 可 以 非常 复杂 。 它 们 能 够 执行 数据 库 访问 
和 依赖 注入 ， 也 能 够 提交 和 重 定向 。 但 是 ， 如 果 使 用 了 这 些 功 能 ， 那 么 Razor 页 面 
与 普通 的 控制 器 驱动 的 视图 就 没有 太 大 区 别 了 


5.2 ”视图 引擎 


视图 引擎 是 MVC 应 用 程序 模型 的 核心 组 件 ， 负 贡 从 视图 创建 HTML。 视 图 通 
第 是 混合 在 一 起 的 HIML 元 双 和 C# 代 人 码 段 。 肖 先 ， 我 们 看 看 最 第 见 的 视图 引擎 触 
上 友 吉 : Controller 基 类 的 View 方法 。 


5.2.1 调用 视图 引擎 


在 控制 需 方 法 内 ， 通 过 调用 View 方法 来 调用 视图 引擎 ， 如 下 所 示 。 


public IActionResult Index() 
{ 
return View(); // same as View("index").; 
} 
View 方法 是 一 个 帮助 程序 方法 ， 负 责 创建 ViewResult 对 象 。ViewResult 对 象 需 
要 知道 视图 模板 (一 个 可 选 的 母 版 页 视角 ), 以 及 要 包含 到 最 终 HTML 中 的 原始 数据 。 


1. View 方法 


虽然 在 这 段 代 码 中 ， 方 法 View 是 没有 参数 的 ， 但 是 这 并 不 意味 看 没有 实际 传 
递 数据 。 下 面 给 出 了 View 方法 的 完整 签名 : 


protected VijiewResult VIew(StrInOI viewName, String masterViewName, ObJject 
ViewModel) 


下 面 是 控制 费 方 法 的 一 个 更 加 第 见 的 模式 : 


public IActionResult Index(...) 

{ 
Var model = GetRawDataForTheView(...); 
return View (model).; 


} 


在 这 里 ， 视 图 的 名 称 默 认为 操作 的 名 称 ， 无 论 操 作 的 名 称 是 从 方法 的 名 称 隐 式 
推 呆 出 来 的 ， 还 是 通过 ActionName 特性 显 式 设置 的 。 视 图 是 一 个 Razor 文件 (市 
有 .cshtml 扩展 名 )， 存 储 在 Views 项 目 文 件 夹 下 。 母 版 页 视图 默认 为 一 个 名 为 
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_Layout.cshtml 的 Razor 文件 ， 其 HIML 布局 是 视图 的 基础 。 最 后 ， 变 量 model 指 
出 了 要 在 模板 中 使 用 的 数据 模型 ， 以 生成 最 终 的 HTML。 
第 6 章 将 更 详细 地 介绍 Razor 语言 的 语法 。 


2. 处 理 ViewResult 对 象 


View 方法 将 Razor 模板 的 名 称 、 母 版 页 视图 和 视图 模型 打包 在 一 起 ,返回 一 个 
实现 IActionResult 接口 的 对 象 。 类 名 为 ViewResult， 它 将 处 理 操 作 方 法 得 到 的 结果 
抽象 了 出 来 。 当 控制 占 方 法 返回 时 ， 还 没有 生成 任何 HTML， 输 出 流 中 也 还 没有 与 
入 任何 东西 。 

public interface IActionResult 

Task ExecuteResultAsync (ActijonContext context) 


} 


可 以 看 到 , IActionResult 接口 的 核心 是 一 个 方法 ExecuteResultAsync， 其 名 称 的 
含义 很 明显 。 在 ViewResult 类 的 内 部 (或 者 说 在 任何 操作 结果 类 的 内 部 )， 都 有 一 段 
逻辑 来 处 理 散 入 的 数据 ， 影 响 生 成 的 啊 应 。 

但 是 ， 触 发 ExecuteResultAsync 方法 的 并 不 
是 控制 占 。 当 控制 占 返 回 时 ， 操 作 调 用 程序 会 获 
取 操 作 结 果 并 执行 。 当 调用 ViewResult 类 实例 的 
ExecuteResultAsync 方法 时 , 束 会 触 友 视图 引擎 来 生 
成 实际 的 HIML 。 


3. 综合 运用 


视图 引擎 是 为 浏览 器 实际 生成 HIML 输出 的 
组 件 。 对 于 每 个 最 终 会 被 控制 器 操作 进行 处 理 来 返 
回 HTML 的 请 求 来 说 ， 视 图 引擎 都 会 发 挥 作用 。 它 
将 视图 的 模板 与 控制 器 传 入 的 数据 混合 在 一 起 ， 从 
而 准备 好 输出 。 

模板 是 用 引擎 特定 的 标记 语言 (如 Razon 来 表 
示 的 ; 传 入 的 数据 则 封装 在 字典 或 强 类 型 的 对 象 图 5-1 控制 器 和 视图 引擎 
中 。 图 5-1 在 整体 上 显示 了 视图 引擎 与 控制 器 如 何 
协同 工作 。 


5.2.2 Razor 视图 引擎 


在 ASPNET Core 中 ， 视 图 引擎 只 是 实现 了 一 个 固定 接口 GViewEngine 接口 ) 的 
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类 ,每 个 应 用 程序 都 可 以 有 一 个 或 多 个 视图 引擎 , 并 在 不 同 的 情况 中 把 它们 全 部 用 上 。 
但 是 , 在 ASPNET Core 中 , 每 个 应 用 程序 只 有 一 个 默认 的 视图 引擎 : RazorViewEngine 
类 。 这 个 视图 引擎 对 开发 影响 最 大 的 地 方 是 其 定义 视图 模板 的 语法 。 
Razor 语法 非 第 清晰 和 友好 。 视 图 模板 实际 上 就 是 一 个 HTML 页 面 ， 其 中 有 一 
些 代 人 码 占 位 人 符 。 每 个 占 位 从 包含 一 个 可 执行 的 表达 式 ， 与 代码 段 很 相似 。 泡 染 视图 
十， 会 计算 代码 段 中 的 代码 ， 所 产生 的 标记 将 被 整 合 到 HTML 模板 。 可 以 使 用 C# 
或 者 .NET Core 平台 文 持 的 其 他 .NET 语言 来 编写 这 种 代码 段 。 


注意 : 
除了 使 用 ASPNET Core 提供 的 RazorViewEnegine 类 ,也 可 以 基于 自 定义 语法 来 
实现 自己 的 视图 引擎 。 


1. Razor 视图 引擎 概述 


Razor 视 岁 引擎 从 便 竹 上 的 一 个 物理 位 置 谈 取 模板 。 每 个 ASPNET Core 项 目 都 
有 一 个 Views 根 文件 夹 ， 模 板 就 存储 在 这 个 文件 夹 下 的 特定 子 目 录 结 构 中 。Views 
文件 夹 通 利 有 一 些 子 文件 夹 ， 每 个 子 文 件 夹 都 按照 已 有 的 控制 器 命名 。 在 每 个 特定 
于 控制 器 的 了 目录 中 有 一 些 物理 文件 ， 其 文件 名 应 该 与 操作 的 名 称 相 匹配 。 文 件 的 
扩展 名 必须 为 .cshtml， 这 样 才能 被 Razor 视图 引擎 读 取 ( 如 果 是 使 用 Visual Basic 编 
写 ASPNET Core 应 用 程序 ， 那 么 扩展 名 必须 为 .vbhtml)。 

ASPNET MVC 要 求 在 存储 每 个 视图 模板 时 ， 其 所 在 的 目录 必须 根据 使 用 该 视 
图 模板 的 控制 器 来 命名 。 如 果 多 个 控制 占 调 用 了 同一 个 视图 ， 则 需要 将 对 应 的 视图 
模板 文件 放 到 Shared 文件 夹 下 。 

要 注意 的 是 ， 在 部 署 站 点 时 ， 生 产 服务 器 上 必须 使 用 Views 文件 夹 下 的 相同 的 
目录 层次 结构 。 


2. 视图 的 位 置 格式 


通过 Razor 视图 引 敬 定义 的 一 些 属性 ， 可 控制 如 何 找 到 视图 模板 。 对 于 Razor 
视 岁 引擎 的 内 部 工作 ， 必 须 在 默认 项 目 配置 中 和 使 用 区 域 时 ， 为 母 版 页 视 岁 、 利 规 
和 分 部 视图 提供 一 个 默认 位 置 。 

表 5-1 显示 了 Razor 视 网 引 擎 文 持 的 位 置 属性 及 对 应 的 预定 义 值 。 
AreaViewLocationFormats 属性 是 一 个 字符 串 列 表 ， 每 个 字符 串 指 同一 个 定义 了 庆 个 
虚拟 路 径 的 占 位 符 字 符 串 。ViewLocationFormats 属性 也 是 一 个 字符 串 列 表 ， 每 个 字 
符 串 指 回 视图 模板 的 一 个 有 效 的 虚拟 路 径 。 


104 


第 5 章 ASPNET MVC 视图 


表 5-1 Razor 视图 引擎 的 默认 位 置 格式 


属性 默认 位 置 格式 
AreaVliewLocationFormats ~/Areas/12}/V1iews/{1}/{0+}.cshtml 
~/Areas/12}/V1iews/Shared/ 01.cshtml 
ViewLocationFormats ~/V1lews/{1 /0+.cshtml 


~/Vliews/Shared/ {0+.cshtml 


可 以 看 到 ， 位 置 不 是 完全 限定 的 路 径 ， 而 是 最 多 包含 3 个 占 位 符 。 
。 占 位 符 {0} 指 代 视图 的 名 称 ， 因 为 它 是 在 控制 器 方法 中 调用 的 。 
。 占 位 符 {1} 指 代 URL 中 使 用 的 控制 器 名 称 。 

。 最 后 ， 如 果 指 定 了 占 位 符 {2}， 则 它 指 代 区 域名 称 。 


注意 : 
如 果 熟 起 经 典 ASPNET MVC 开发 ， 可 能 会 惊讶 地 发 现 ， 在 ASPNET Core 中 ， 
不 存在 分 部 视图 和 布局 的 视图 位 置 格式 。 在 第 6 章 将 看 到 ， 一 般 来 说 ， 视 图 、 分 部 
视图 和 布局 很 相似 ， 系 统 按照 相同 的 方式 发 现 和 处 理 它 们 。 这 可 能 是 做 出 上 述 决 定 
的 理由 。 因 而 ， 要 想 为 分 部 视图 或 布局 视图 添加 一 个 自 定义 视图 位 置 ， 只 需要 添加 
到 ViewLocationFormats 列表 中 。 


3. ASP.NET MVC 中 的 区 域 


区 域 是 MVC 应 用 程序 模型 的 一 项 功能 ， 用 于 将 应 用 程序 内 的 相关 功能 分 组 到 
一 起 。 使 用 区 域 就 像 是 使 用 多 个 子 应 用 程序 ， 是 将 较 大 的 应 用 程序 分 区 成 较 小 的 片 
段 的 一 种 方法 。 

区 域 提供 的 分 区 类 似 于 命名 空间 ， 在 MVC 项 目 中 ， 添 加 一 个 区 域 (可 通过 Visual 
Studio 沫 单 实现 ) 将 导致 添加 一 个 项 目 文件 严 ， 其 中 有 目 己 的 控制 器 、 模 型 关 型 和 视图 。 
这 了 怠 允 许 针 对 应 用 程序 的 不 同 区 域 有 了 两 个 或 更 多 个 HomeController 类 。 是 奋进 行 区 域 分 
区 目 行 决定 ， 并 不 一 定 是 功能 性 的 。 我 们 也 可 以 考虑 针对 每 个 角色 一 对 一 地 使 用 区 域 。 

究 其 根本 ， 区 域 不 是 搁 术 性 或 者 功能 性 的 ， 相 反 ， 它 们 主要 与 项 目 和 代码 的 设 
计 和 组 织 有 关 。 使 用 区 域 时 ， 它 们 会 对 路 由 产生 影响 。 在 传统 路 由 中 ， 区 域 的 名 称 
是 另 一 个 要 考虑 的 参数 。 更 多 信息 请 访问 http://docs.microsoft.com/en-us/aspnet/core/ 
mvc/controllers/areas 这 个 网 址 。 


4. 自 定义 位 置 格式 


回顾 十 多 年 来 的 ASPNET MVC 编程 ， 我 发 现 几 乎 任何 中 等 复杂 度 的 生产 应 用 
程序 中 , 我 最 终 都 使 用 了 一 个 自 定 义 视图 引擎 ， 更 常见 的 情况 是 , 使 用 了 默认 Razor 
视图 引擎 的 一 个 目 定 义 版 本 。 
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之 所 以 不 使 用 默认 的 配置 而 使 用 自 定 义 的 配置 ， 主 要 的 怕 因 是 为 了 在 特定 的 文 
件 夹 中 组 织 视图 和 分 部 视图 ， 以 便当 视图 和 分 部 视图 的 数量 超过 几 十 个 的 时 候 ， 能 
够 更 快速 、 更 简单 地 获取 文件 。 可 按照 任意 命名 约定 ， 为 Razor 视图 任意 命名 。 虽 
然 严 格 来 说 ， 并 不 需要 采用 命名 约定 ， 也 不 需要 按照 自 定 义 的 方式 来 组 织 文 件 ， 但 

是 它们 对 于 管理 和 维护 代码 来 说 很 有 帮助 。 

我 最 豆 欢 有 的 命名 约定 是 在 视图 名 称 中 使 用 本 级 。 例 如 ， 我 的 分 部 视图 部 以 pv_ 
开头 ,而 布局 文件 都 以 layout 开头 。 这样 一 来 , 即使 同一 个 文件 中 包含 了 许多 文件 ， 
它们 也 都 是 按 名 称 分 组 的 ， 很 容易 找到 需要 的 文件 。 而 且 ， 我 仍然 喜欢 公 少 为 分 部 
视图 和 布局 使 用 一 些 和 额外 的 子 文 件 来。 下面 的 代码 显 示 了 在 ASPNET Core 中 如 何 
目 定 义 视图 位 置 。 


Public void ConfigureServices (IServiceCollection services) 
{ 
Services 
-AddMvc() 
-AddRazorOptions (options => 
{ 
// Clear the current list of view location formats. At this time, 
// the list contains default view location formats. 
optlions.ViewLocationFormats.Clear(); 


// {0} = Action Name 
// {1} =- Controller Name 
// {2} - Area Name 
options.ViewLocationFormats.Add ("/Views/{1}/{0}.cshtml");} 
options.ViewLocationFormats.Add ("/Views/Shared/{0}.cshtml"); 
options.ViewLocationFormats.Add("/Views/Shared/Layouts/{0}.cshtml"™"); 
options.ViewLocationFormats.Add ("/Views/Shared/PartialViews/1{0}. 
cshtml™); 
}); 
} 


调用 Clear 清空 了 的 认 的 视图 位 置 字 符 串 列 SoltionEplorer x 
表 , 使 系统 只 会 根据 目 定 义 的 位 置 规则 工作 。 图 5-2 ee 名 部 -| 四- 二 回回 | 3 


i | Search Solution Explorer (Ctr|+é) 
显 修 \ 了 在 一 个 示例 巧 项 日 中 得 到 的 文件 夹 经 生 于 构 。 9 注 的 ] solution "ViewConfig' (1 project) 
we 4 Vi a 
意 和 现在 只 有 当 位 je Views/Shared 或 Views/ Shared/ gt Sernvices 


Dependencies 


Partial Views 中 时 才 和 EE 发现 分 部 视图 Wy 当 位 了 £ Properties 


过 WwWwWrOet 


Views/Shared 或 Views/Shared/Layouts 中 时 才能 发 Conuoler 
现 布局 文件 。 b 有 Home 


2 层 | Shared 
Layouts 


i ee 
如 果 不 太 热 秋分 部 视图 和 布局 文件 的 概念 ee 
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CH Startup.cs 


也 不 必 担 心 。 下 一 章 将 通过 示例 详细 介绍 它们 。 


Build & RR... lution..， Tearn Expl.， Server EX. 


图 5-2” 自 定义 的 视图 位 置 


第 5 章 ASPNET MVC 视图 


5. 视图 位 置 扩展 器 


倪 图 位 el la 又 站。 在 应 用 程序 局 动 时 定义 视图 位 管 格式 ， 
之 后 在 应 用 程序 的 整个 生存 期 内 ， 它 们 都 是 油 活 的 。 每 当 必 须 泻 染 一 个 视图 时 ， 视 
图 引 获 就 合 看 已 注册 位 管 的 列表 ， 直 到 找到 一 个 包含 期 望 模板 的 位 置 。 如 果 没 有 找 

到 模板 ， 束 抛 出 一 个 异常 。 目 前 来 说 一 切 都 没 问 题 。 

但 是 ， 如 果 需 要 根据 每 个 请 求 ， 动 态 人 确定 视图 的 路 笃 ， 该 怎么 办 ? 也 许 你 觉得 
这 种 用 例 很 奇怪 ， 但 是 考虑 一 下 多 租户 应 用 程序 。 假 设 有 一 个 应 用 程序 作为 服务 ， 
被 多 个 客户 并 及 地 使 用 。 人 代码 库 始 终 是 相同 的 ， 光 和 辑 视 狗 始终 是 相同 的 ， 但 是 每 个 
用 户 会 看 到 视图 的 特定 版 本 ， 可 能 在 样式 上 发 生 了 变化 ， 或 者 具有 人 不同 的 布局 。 

对 于 这 类 应 用 程序 ， 一 种 常见 的 方法 是 定义 默认 视图 的 集合 ， 然 后 允许 客 尸 添 
加 目 定 义 的 视图 。 例 如 ， 假 设 客 尸 Contoso 导航 到 了 视图 index.cshtml， 期 望 看 到 
Views/Contoso/Home/index.cshtml， 而 个 是 默认 视图 Views/Home/index.cshtml。 如 何 
编写 代 个 呢 ? 

在 经 典 ASPNET MVC 中 ， 必 须 创 建 一 个 日 定义 视图 引 擎 ， 并 莲 写 寻找 视图 的 
逻辑 。 工 作 量 并 不 是 特别 大 ， 只 需要 添加 几 行 代码, 但 是 必须 运行 目 己 的 视图 引擎， 
并 认真 学 习 其 内 部 机 制 。 在 ASPNET Core 中 ， 新 添加 了 视图 位 置 扩展 器 组 件 ， 用 
于 动态 解析 视图 。 视 图 位 置 扩展 占 是 实现 了 IViewLocationExpander 接口 的 一 个 类 。 


public class MultiTenantViewLocationExpander : IViewLocationExpander 


{ 
Public void PopulateValues (VijewLocationExpanderContext context) 
1 
var tenant = context.ActionContext.HttpContext .ExtractTenantCode () ， 
context .Values|["tenant"| = tenant; 
} 


Public IEnumerable<string> ExpandViewLocations ( 
ViewLocationExpanderContext context, 
IEnumerable<string> viewLocations) 


if (Icontext -Values -ContalnsKevy( 七 Enant ) || 
string.IsNullOrwWwhiteSpace (ConteXt -Values [ 七 Enamnt |]) ) 
return viewLocations; 


Var tenant = context .Values|"tenant™ |; 

Var Views = ViewLocations 
.Select (f => f.Replace ("/Views/", "/Views/" + tenant + "/")) 
.Concat (viewLocations) 
.TOL1St(); 

return views; 


} 


在 PopulateValues 中 ， 访 问 HITP 上 上 下文， 并 决定 使 用 哪个 键 值 来 确定 要 使 用 
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的 视 多 路径 。 这 可 能 怠 是 通过 采种 方式 从 请 求 URL 中 提取 出 的 租户 代码 。 用 于 确 
定 路 任 的 键 值 存储 在 视图 位 置 扩展 右上 下 文中 。 在 ExpandViewLocations 中 ， 接 受 
当前 视图 位 置 格 式 列 表 ， 基 于 当前 上 下 文 进行 合适 的 编辑 ， 然 后 返回 这 个 列表 。 编 
和 辑 列 表 通 第 意味 看 插入 额外 的 、 特 定 于 上 下 文 的 视图 位 置 格式 。 

根据 上 和 面 的 代码 ， 如 果 收 到 来 日 http://contoso.yourapp.com/home/index 的 请 求 ， 
并 且 租 户 代 人 码 是 contoso， 那 么 返回 的 视图 位 置 格式 列表 可 能 如 图 5-3 所 示 。 


= “AVhews/contosor[ MY 的 :cshtrml xpanderContext context, IE 
= "Mews/econtoso/Shared/ Ol.eshtrml" 

=- "Mewscontoso/Sshared/Layouts/tQl.cshtml" 

"Views/contoso/shared/Partialvievwsdl.cshtml" 


0 references 
public TIEnumerable<si ® ol 
| 鄂 [1] 


{ 


var overriddenVia 
.Select(f =>| 
.Concat (viewl 


™ "Views/(1 MO}.cshtml" <t.Values["tenant"] + "/")) 
= "Wiews/Shared/{O}.cshtmt 

"Views/Shared/Layouts/t0}.cshtml" 

-WhewsShared/PartialViews/t0l.cshtml" 


Pppppppp 


.ToList(); 


overriddenViewhNames Count = 8 己 - 


图 5-3 为 多 租户 应 用 程序 使 用 日 定义 位 置 扩展 此 


列表 项 部 已 经 添加 了 租户 特定 的 位 置 格式 ， 说 明 任何 重 写 的 视 岁 将 比 默 认 视 各 
的 优先 级 更 高 。 
目 定 义 扩 展 堆 必须 在 局 动 阶段 注册 ， 方 法 如 下 : 


Public void ConfigqureServices (IServiceCollection services) 


{ 
SeTVLCeS 
.AddMvc () 
.AddRazorOptions (options 三 > 
{ 
options .ViewLocationExpanders .Add (new 
MultijTenantViewLocationExpander ()) ; 

}); 

} 


注意 ， 在 责 认 情况 下 ， 系 统 中 没有 注册 任何 视图 位 置 扩 展 颖 。 


ASPNET Core 提供 的 视图 位 置 扩展 器 组 件 使 得 对 自 定 义 视 图 引擎 的 需求 大 大 
降低 ， 人 至 少 在 使 用 自 定 义 视图 引擎 来 自 定义 检索 和 处 理 视图 的 方式 方面 如 此 。 目 定 
义 视 图 引擎 基于 IViewEngine 接口 ， 如 下 所 示 。 


public interface IViewEngine 
{ 
ViewEngineResult FindView (ActijonContext context, string VviewName, bool 
lsMainPpage); 
ViewEngineResult GetView(string executingFilePath, string viewPath, bool 
lsMaijnpPpage);} 


} 


FindView 方法 负 贡 找到 指定 的 视图 ， 在 ASPNET Core 中 ， 通 过 位 置 扩 展 占 可 
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在 很 大 程度 上 目 定 义 其 行为 。 与 之 相对 ，GetView 则 负责 创建 视图 对 象 ， 即 将 被 泻 
染 到 输出 流 以 捕捉 最 终 标 记 的 那个 组 件 。 通 第 ， 除 非 填 要 做 一 些 反 第 的 事情 ， 如 改 
变 模板 语言， 奋 则 不 需要 午 写 GetView 的 和 行为 
如 今 ， 对 于 大 部 分 情况 来 说 ， 使 用 Razor 语言 和 Razor 视图 束 是 够 了 ， 而 旦 其 
他 视图 引擎 的 例子 很 宇多 。 但 是 ， 一 些 开发 人 员 开发 了 一 些 项 目 来 创建 和 改进 其 他 
视图 引擎 ， 这 些 引 敬 使 用 Markdown(MD) 语 言 来 表达 HIML 内 容 。 在 我 看 来 ， 这 是 
少数 必须 创建 (或 使 用 ) 目 定义 视图 引擎 的 情况 之 一 。 
无 论 如 何 ， 如 果 正 好 有 一 个 目 定 义 视图 引擎 ， 那 么 可 以 在 ConfigureServices 中 
使 用 下 面 的 代 但 将 其 添加 到 系统 中 。 
services.addMvc () 
.addViewoptions (options => 
options.ViewEngines.Add (new SomeotherViewEngine () ) ; 
}); 
注意 ，RazorViewEngine 是 ASPNET Core 中 唯一 注册 的 视图 引擎 。 因 此 ， 上 面 
的 代码 只 是 添加 了 一 个 新 引擎 。 如 果 想 要 用 上 自己 的 引擎 蔡 换 默认 的 引擎 ， 则 必须 清 
宇 ViewEngines 集合 ， 然 后 注册 目 己 的 新 引擎 。 


5.2.4 Razor 视图 的 结构 


从 拉 术 上 讲 ， 视 图 引擎 的 主要 目的 是 从 模板 文件 生成 一 个 视图 对 象 ， 并 提供 视 
图 数据 。 然后, 操作 调用 程序 基础 结构 会 使 用 视图 对 和 象 , 并 生成 实际 的 HTML 啊 应 。 
因此 ， 每 个 视图 引擎 都 定义 了 目 己 的 视图 对 象 。 接 下 来 将 介绍 默认 的 Razor 视图 引 
擎 管理 的 视图 对 和 象 。 


1. 视图 对 象 概述 


如 前 所 述 ， 当 一 个 控制 器 方法 调用 控制 占 基 类 的 View 方法 来 演 染 特定 的 视图 
时 ， 将 触发 视 几 引擎 。 此 时 ， 操 作 调 用 程序 ( 即 管理 任何 ASPNET Core 请 求 的 执行 
的 系统 组 件 ) 将 授 历 已 注册 视图 引擎 的 列表 , 给 每 个 视图 引擎 一 个 处 理 视 图 名 称 的 机 
会 。 这 是 通过 FindView 方法 的 服务 实现 的 。 

视图 引擎 的 FindView 方法 收 到 视图 名 称 ,确认 在 其 文 持 的 文件 夹 树 中 是 侍 存 在 
一 个 模板 文件 具有 给 定 的 名 称 和 合适 的 扩展 名 。 如 果 找 到 匹配 ， 将 触发 GetView 方 
法 来 解析 文件 内 容 ， 并 准备 新 的 视图 对 象 。 从 根本 上 看 ， 视 图 对 象 是 一 个 实现 了 
IView 接口 的 对 象 。 

public interface IView 


{ 
string Path { get; } 
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Task RenderAsync (ViewContext ConteXt) ， 


} 
操作 调用 程序 只 是 调用 RenderAsync 来 生成 HIML， 并 将 其 写 出 到 输出 流 。 
2. 解析 Razor 模板 


解析 Razor 梗 板 文件 将 把 静态 文本 与 语言 代码 段 区 分 开 。Razor 模板 文件 实际 
上 就 是 HIML 模板 ， 其 中 罕 插 了 一 些 用 C# 语 言 (或 者 ASPNET Core 平台 文 持 的 其 
他 任何 语言 ) 编 写 的 代码 块 。 任 何 C# 代 码 段 的 前 面 必须 带 有 @ 符 号 作 为 前 前 级 。 下 面 
显示 了 一 个 Razor 模板 文件 的 示例 (这 个 示例 模板 是 第 6 草 要 介绍 的 内 容 的 一 个 人 简略 
版 本 ; 在 第 6 章 中 ， 我 们 将 深入 讨论 Razor 模板 的 所 有 语法 方面 )。 


<1-- test.cshtml located in Views/Home 一 一 > 


<hl>Hi everybody!l</hl1> 
<p>It's Ql@DateTime.Now.ToString ("hh:mm")</p> 
<hr> 
Let me count till ten. 
<ul> 
Qfor (Var i=l; i<=]0; i++) 
{ 
<1i>Qi</1i> 
} 


< > 


模板 文件 的 内 容 被 分 解 为 一 个 文本 项 列表 ， 这 些 文本 项 属于 两 个 类 型 : 静态 
HTML 内 容 和 代码 段 。Razor 解析 占 构 建 的 列表 如 表 5-2 所 示 。 


表 5-2 解析 Razor 模板 示例 得 到 的 文本 项 列表 


内 容 内 容 类 型 
<hl>Hi everybody!</hl><p>It’s 静态 内 容 
DateTime.Now.ToStrne("hh:mm") 代码 段 
</p><hr>Let me count tl ten.<ul> 静态 内 容 
for(var 天 1; 1<=10; 1++) 代码 段 
ft 
} 
一 静态 内 容 ( 在 for 循环 中 递归 处 理 ) 
I 代码 段 (在 for 循环 中 递归 处 理 ) 
ee 静态 内 容 (在 for 循环 中 递归 处 理 ) 
一 静态 内 容 


四 符号 告诉 解析 器 ， 在 这 个 位 置 将 发 生 毅 态 内 容 到 代码 段 的 过 渡 。@ 符 号 后 面 
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的 任何 文本 将 按照 所 文 持 语言 (在 这 里 是 C# 语 言 ) 的 语法 规则 来 解析 。 
3. 从 Razor 模板 构造 视图 对 象 


Razor 模板 文件 中 所 发 现 的 文本 项 为 动态 构造 C# 关 打下 了 基础 ， 构 造 出 的 C# 
类 能 够 完全 代表 模板 。 通 过 使 用 .NET 平台 的 编 详 器 服务 (Roslyn)， 动 态 地 创建 和 编 
详 C# 闫 。 假 设 示 例 Razor 文件 被 命名 为 test.cshtml， 位 于 Views/Home 下 ， 那 么 实 
际 的 Razor 视图 类 将 悄悄 生成 下 和 面 的 代码 。 


// The code below is NOT an exact printout of the actual code being generated. However 

// it shows the fundamental things. Other lines, not relevant for our purposes, have 

// been removed for clarity and brevity. The substance of the behavior, though, is 
all here. 


public class Views Home Test cshtml : RazorPage<dynamic> 
{ 
Public override async Task EXecCuteAsYncC () 
| 
WriteLiteral ("<hl>Hi everybody!</hl>\rm\n<p>It\'s "™); 
Write (DateTime.Now.ToString("hh:mm" )); 
WriteLiteral ("</p>\r\n<hr>\r\nLet me count 七 Ii11 ten.\r\n<ul>\r\n"); 
fortvar i=l; i<~=10; i++) 
{ 
WriteLiteral (<11i>");}; 
WriteLiteral ("</li>"); 
} 
WriteLiteral (™</ul>\r\n"); 


} 

这 个 类 继承 日 RazorPage<T>， 后 者 义 实现 了 IView 接口 。 由 于 RazorPage<T> 
基础 页 和 耐 预 定义 的 一 些 成 员 ( 位 于 Microsoft.AspNetCore.Mvc.Razor 命名 空间 内 )， 
此 可 以 使 用 看 起 来 魔 约 的 对 象 在 Razor 模板 体内 访问 请 求 和 你 日 己 的 数据 。Html、 
Url、Model 和 ViewData 是 一 些 明 显 的 例子 。 第 6 章 在 介绍 用 于 生成 HIML 视图 的 
Razor 语法 时 ， 将 展示 这 些 属 性 对 象 的 应 用 。 

大 部 分 时 候 ，Razor 视图 是 多 个 .cshtml 文件 组 合 在 一 起 的 结果 ， 如 视图 本 号、 
布局 文件 和 两 个 可 选 的 全 局 文件 (分 别 是 ViewStart.cshtml 和 ViewImports.cshtml)。 
表 5-3 解释 了 这 两 个 文件 的 作用 。 


表 5-3 ” Razor 系统 中 的 全 局 文件 


文件 名 用 途 
_ViewStart cshtml 包含 在 泻 染 任何 视图 之 前 运行 的 代码 。 可 以 使 用 这 个 文件 来 添加 应 用 


程序 中 的 所 有 视图 所 共有 的 配置 代 但 。 通 第 使 用 这 个 文件 来 为 所 有 的 
视图 指定 一 个 默认 布局 文件 。 这 个 文件 必须 放 在 根 Views 文件 夹 中 。 
经 由 ASPNET MVC 也 支持 这 个 文件 
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文件 名 用 途 
_ ViewImports.cshtml 包含 要 在 有 所有 视图 中 共享 的 Razor 指令 。 可 以 在 不 同 的 视图 文件 夹 中 
有 这 个 文件 的 多 个 部 分 ,其 内 容 会 影 啊 相 同文 件 夹 及 子 文 件 夹 内 的 所 
有 人 视图， 除非 子 文 件 夹 中 有 该 文件 的 为 一 个 副本 。 经 典 ASP.NET 不 
支持 此 文件 。 不 过 ， 在 经 典 ASPNET 中 ， 使 用 web.config 文件 可 实 
现 相 同 的 作用 


当 多 个 Razor 文件 起 作用 时 ， 编 详 过 程 将 分 步 怒 进行。 站 先 处 理 布 局 模板 ， 然 
后 是 _ViewStart 和 实际 的 视图 。 之 后 合并 输出 , 这 样 _ViewStart 中 的 公共 代码 将 在 视 
图 之 前 渔 染 ， 而 视图 则 在 布局 内 输出 其 内 容 。 


注意 : 
在 运行 ASPNET Core MVC 应 用 程序 时 ， 表 5-3 中 的 文件 是 唯一 可 能 需要 全 局 
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使 用 的 文件 。 在 Visual Studio 2017 中 ， 一 些 预定 义 的 应 用 程序 模板 会 创建 其 他 一 些 
文件 (如 ValidationScriptsPartial.cshtml). 对 于 这 些 文件 , 我 们 可 以 轻松 愉快 地 忽略 它 
们 ， 除 非 觉得 它们 有 帮助 。 


4. Razor 指令 


Razor 解析 器 和 代码 生成 器 的 行为 受到 一 些 可 选 指令 的 驱动 , 可 以 使 用 这 些 指 
邻 来 进一步 配置 演 染 上 下 文 。 表 5-4 给 出 了 一 些 常 用 的 Razor 指令 。 


表 5-4 最 常用 的 Razor 指令 


指令 用 和 途 
@using 。 | 在 编译 上 下 文中 添加 一 个 命名 空间 。 与 C# 的 using 指令 相同 


(Vusing MyApp.Functions 

@inherits 指出 了 为 动态 生成 的 Razor 视图 对 象 使 用 的 实际 基 类 。 天 认 情况 下 ， 基 类 为 
RazorPage<T>,， 但 是 @inherits 指令 允许 使 用 一 个 目 定 义 基 关 ， 而 这 个 月 定义 基 
类 必须 继承 RazorPage<T> 
(Vinhernits MyApp.CustomRazorPage 

(vmodel 指出 了 用 来 辐 视 图 传 谴 数据 的 类 的 类 型 。 通 过 @model 指令 指定 的 类 型 成 为 
RazorPage<T> 的 泛 型 参数 T。 如 末 没 有 指定 ， 则 工 默 认为 dynamic 
(nodel MyApp.Models.HomeIndexViewModel 

Cimlect 在 视图 上 下 文中 注入 指定 类 型 的 一 个 实例 ， 该 类 型 绑 定 到 给 定 的 属性 名 。 此 指 
令 依 赖 于 系统 的 DI 基础 结构 


(Vinject IHostingEnvironment CurrentEnvironment 
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(@using 和 @model 指令 在 每 个 Razor 视图 中 几乎 都 可 以 看 到 。@inject 指令 则 代 
表 了 Razor 视图 和 ASPNET Core 的 DI 系统 的 连接 点 。 通 过 @inject， 可 以 解析 任何 
注册 的 类 型 ， 并 在 视图 中 有 该 类 型 的 一 个 全 新 实例 。 在 为 Razor 视图 动态 生成 的 代 
码 中 ， 可 以 通过 同名 的 属性 来 访问 注入 的 实例 。 


5. 预 编译 视图 


当 调 用 视图 时 ， 将 动态 地 生成 并 编译 Razor 视图 。 生 成 的 程序 集 将 被 缓存 ， 只 
有 当 系统 检测 到 Razor 视图 模板 已 被 修改 时 ， 才 会 删除 缓存 的 程序 集 。 检 测 到 这 种 
修改 后 ， 将 在 首座 访问 视图 时 ， 重 痢 生 成 和 重新 编 详 视图 。 
从 ASPNET Core 1.1 开始 , 可 以 选择 预 编 详 Razor 视图 , 把 它们 作为 应 用 程序 的 程 
序 集 部 署 。 请 求 预 编 译 相 对 简单 ， 可 手动 或 通过 IDE 界面 (如 果 IDE 文 持 ) 来 修改 .csproj 
文件 。 我 们 只 需要 引用 程序 包 MicrosoftAspNetCore.Mvc.RazorViewCompilation， 并 
确保 .csproj 文件 中 包含 下 面 的 内 容 : 
<PropertycGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
<MvyvcRazorCompileOnPublish>true</MvcRazorCompileOnPublish> 


<PreserveCompilationContext>true</PreserveCompilationContext> 
</PropertyGroup> 


总 而 言 之 ， 考 虑 预 编 详 视 岁 有 两 个 原因 。 然 而 ， 这 两 个 怕 因 是 何 适 合 目 己 的 情 
况 ， 需 要 开 友 团队 目 己 决定 。 如 果 部 莹 了 预 编 详 视 图 ， 那 么 第 一 个 访问 视图 的 用 三 
会 更 加 快速 地 看 到 页 向 。 第 二 个 原因 是 ， 在 预 编 详 步 又 中 ， 任 何 没有 发 现 的 编 详 馈 
误会 更 快 浮现 ， 可 航 立 即 修复 。 对 我 来 说 ， 第 二 个 原因 要 比 第 一 个 原因 吏 有 说 服 力 。 
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5.3 回 视 图 传 违 效 气 


可 以 有 3 种 不 同 的、 彼此 不 互 斥 的 方法 来 癌 Razor 视图 传递 数据 。 在 ASPNET 
Core 中 ， 还 有 第 4 种 方式 : 通过 @inject 指令 实现 的 依赖 注入 。 我 们 既 可 以 使 用 内 
置 的 两 个 字典 一 一 ViewData 和 /或 ViewBag, 也 可 以 使 用 强 类 型 的 视图 模型 类 ,纯粹 
从 功能 的 角度 看 ， 这 些 方法 之 间 没 有 区 别 ， 甚 至 从 性 能 的 角度 看 ， 区 别 也 微乎其微 。 

但 是 ， 在 设计 、 可 读 性 以 及 可 维护 性 方面 ， 这 些 方法 存在 巨大 的 差异。 在 这 几 
个 方面 ， 强 类 型 的 视图 模型 类 的 表现 更 好 。 


5.3.1 ”内置 的 字典 


控制 亏 问 视图 传递 数据 时 ， 最 简单 的 方法 是 将 信息 仓 入 一 个 名 称 /人 字典 中 。 这 
有 两 种 实现 方式 。 
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1. ViewData 字典 


ViewData 是 一 个 经 典 的 名 称 / 值 字 典 。 属 性 的 实际 类 型 是 ViewDataDictionary， 
它 没 有 继承 系统 的 任何 字典 类 型 ， 但 是 仍然 公开 了 .NET Core 框架 中 定义 的 公共 字 
典 接 口 。 

Controller 基 关 提供 了 一 个 ViewData 属性 ， 该 属性 的 内 容 被 目 动 刷新 到 视图 苔 
后 动态 创建 的 RazorPage<T> 类 实例 中 。 这 总 味 看 控制 桌 ViewData 中 存储 的 任何 值 
都 可 在 视图 中 使 用 ， 而 不 需要 人 为 做 任何 进一步 的 操作 。 

public IActionResult Index() 

ViewData["PageTitle"] = "Hello"; 


ViewDatal"Copyright"| “(cc) Dino Esposito"s 
ViewDatal"CopyrightYear™"| = 2011; 


return View (); 
} 
index.cshtml 视图 并 不 需要 声明 一 个 模型 类 型 ， 而 可 以 直接 读 取 任何 传 入 的 数 
据 。 第 一 个 机 会 出 现 了 。 负 贡 编 与 视图 的 开 友 人 员 可 能 并 不 知道 通过 字典 传 入 了 什 
么 数据 。 她 只 能 依赖 内 部 文档 和 实际 的 沟通 ， 或 者 在 Visual Studio 中 设置 断 点 来 检 
查 字 典 ， 才 能 知道 其 中 的 数据 ， 如 图 5-4 所 示 。 无 论 是 哪 种 情况 ， 即 使 同一 个 人 既 
编号 了 控制 器 ， 又 编写 了 视图 ， 这 也 都 不 会 是 一 个 愉快 的 经 历 。 


4 pp ViewData {MicrosoftAspNetCore.MvcViewH 
pp Count 
Db 拓 Data 
PUBLIC FRONTEND! PP IsReadOnly 


bp Keys 
</ hl1> b pp Model (MicrosoftAspNetCore.Mvc.Viewl 


<hr /> b pp Model 


b pp ModelExplorer 
b ps ModelMetadata 
=<a role= button class=/b £ ModelState 


Take me to the PRIV®° "Platelnfo 
b ££ Values 
/> Db Gs data 
Db Bs declaredModelType 
Db RB _ metadataProvider 
4@ResutsView 


图 5-4 在 Visual Studio 中 查看 ViewData 字典 的 内 容 


男 外 ， 考 虑 到 ViewData 条 目 是 通过 名 称 标识 的 (例如 魔 约 字符 串 )， 所 以 代 但 中 
很 容易 出 现 拼写 错误 。 在 这 种 情况 下 ， 即 使 预 编 详 视 图 ， 也 难以 避免 总 想 不 到 的 运 
行 时 卉 第 或 难以 预料 的 错误 内 容 。 使 用 钊 量 而 不 是 魔 约 衬 符 串 能 够 减轻 这 个 问题 ， 
但 代价 是 必须 为 这 些 常 量 以 及 传递 给 视图 的 整个 数据 集合 编写 内 部 文档 。 
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ViewData 字典 是 一 个 字符 串 / 对 象 字典 ， 这 意味 看 其 中 存储 的 任何 数据 都 被 公 
开 为 一 个 泛 型 对 象 。 如 果 只 是 在 视图 中 显示 一 个 相对 小 的 字典 中 的 内 容 ， 那 么 这 可 
能 没什么 关系 。 但 是 ， 对 于 较 大 的 字典 ， 可 能 会 发 现状 箱 / 拆 箱 导 伊 的 性 能 问题 。 如 
果 需 要 使 用 ViewData 中 的 一 些 条 目 进行 比较 或 者 执行 其 他 对 类 型 敏感 的 操作 , 那么 
必须 先 执行 类 型 转换 ， 人 然后 再 获取 可 用 的 值 。 

对 于 使 用 ViewData 这 样 弱 类 型 的 字典 ， 最 有 说 服 力 的 理由 是 在 编程 时 ， 它 们 
使 用 起 来 简单 快捷 。 但 是 ， 这 种 优势 的 代价 是 代 但 会 很 脆弱 ， 而 想 要 让 代 但 不 那 
么 脆弱 ， 所 要 付出 的 努力 塔 比 使 用 强 类 型 的 类 ， 但 却 没 有 使 用 强 类 型 的 类 时 加 有 
的 清晰 性 。 


ph | 
f f 
i 
f | 
站 
| 有 


虽然 我 们 不 建议 在 Web 应 用 程序 中 大 量 使 用 ViewData 字典 ， 但 是 我 们 也 认识 
到 ， 在 一 些 边缘 用 例 中 ， 例 如 当 无 法 更 新 强 类 型 的 模型 (例如 源 代码 不 归 你 所 有 ) 但 
仍然 需要 向 视图 传递 额外 的 数据 时 ， 它 们 能 够 救急 。 事 实 上 ， 如 前 所 述 ， 字 典 和 视 
图 模型 是 可 以 结合 使 用 的 。 在 另外 一 个 不 易 处 理 的 场景 中 ， 有 时 能 够 同时 使 用 字典 
和 强 类 型 的 视图 模型 ， 这 种 场景 就 是 从 视图 向 子 分 部 视图 传递 数据 。 第 6 章 在 介绍 
分 部 视图 时 ， 将 讨论 这 种 场景 。 


2. ViewBag 动态 对 象 


ViewBag 是 Controller 基 类 上 定义 的 男 外 一 个 属性 ， 其 内 容 将 目 动 刷 狐 到 视图 
类 中 。ViewBag 与 ViewData 不 同 ， 它 允许 代码 直接 访问 自己 的 属性 ， 从 而 避免 了 
ViewData 文 持 的 标准 字典 访问 。 下 向 给 出 了 一 个 例子 : 


public IActionResult Index() 


{ 
ViewBag.CurrentTime = DateTime .Now; 
ViewBag.CurrentTimeForDisplay = DateTime.Now.ToString ("HH:mm" ) 
return View(); 

} 


注意 , 对 ViewBag 使 用 索引 器 的 访问 操作 将 会 失败 , 导 禾 一 个 列 弟 。 换 句 话说 ， 
下 向 的 两 个 表达 式 并 不 相同 ， 只 有 前 一 个 表达 式 才 能 工作 。 


ViewBag.CurrentTimeForDisplay = DateTime.Now.ToString("HH:mm"); // works 
ViewBag["CurrentTimeForDisplay"] = DateTime.Now.ToString ("HH:mm"); // throws 


值得 注意 的 是 ，ViewBag 并 不 包含 CurrentTime 和 CurrentTimeForDisplay 等 属 
性 的 定义 ,可 以 在 ViewBag 对 象 引 用 的 后 面 键入 任何 属性 名 , C# 编 译 占 并 不 会 报 针 。 
原因 在 于 ，Controller 基 类 将 ViewBag 定义 为 一 个 DynamicViewData 属性 ， 而 
DynamicViewData 是 一 个 ASPNET Core 类 型 ， 其 定义 如 下 所 示 。 
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namespace Microsoft.AspNetCore.Mvc.ViewFeatures.1Internal 


{ 
Public class DynamicViewData : DYnamlcoOb]ect 
{ 
} 

} 


C# 语 言 通过 动态 语言 运行 时 (Dynamic Language Runtime，DLR) 文 持 动 态 功 能 ， 
DynamicObject 类 束 包 含 在 DLR 中 。 每 当 C# 编 详 带 迪 到 动态 类 型 变量 的 引用 时 ， 
束 会 跳 过 类 型 检查 ， 并 生成 一 些 代码， 最 终 让 DLR 在 运行 时 解析 调用 。 这 总 味 看 
即使 对 于 预 编译 视图， 也 只 会 在 运行 时 才能 发 现 镜 误 (如 果 存 在 销 误 的 话 )。 

ViewBag 的 男 外 一 个 值得 注意 的 方面 是 ， 其 内 容 将 目 动 与 ViewData 字典 同步 。 
这 是 因为 DynamicViewData 类 的 构造 函数 会 收 到 ViewData 字典 的 一 个 引用 ， 并 读 
与 对 应 的 ViewData 条 目的 什 。 因 此 ， 下 面 的 两 个 表达 陈 是 等 效 的 。 


Var pl = ViewDatal" PageTitle" |]; 
Var p22 = ViewBag.PageTitle; 


那么 ， 使 用 ViewBag 有 什么 意义 呢 ? 

总 的 来 看 ，ViewBag 只 是 明显 很 酷 。 通 过 去 除 难 看 的 、 基 于 字典 的 代码 ， 它 使 
代码 看 起 来 更 加 美观 ， 代 价 是 需要 信 助 使 用 DLR 解释 的 代码 来 进行 谈 号 。 这 样 一 
来 ， 它 允许 定义 实际 上 可 能 并 不 存在 的 属性 ， 所 以 甚至 不 能 避免 在 运行 时 出 现 null 
引用 弄 第 。 


注意 : 
从 ASPNET Core 控制 器 和 视图 传递 数据 时 ， 使 用 ViewBag 这 样 的 动态 对 象 并 
不 合理 ， 但 是 在 C# 中 提供 动态 功能 的 回报 很 丰盛 。 例 如 ，LINQ 和 社交 网 络 API 会 
使 用 语言 中 的 这 种 动态 功能 。 


5.3.2 强 类 型 视图 模型 


一 些 开 友人 员 似 乎 不 喜欢 使 用 模型 类 ， 因 为 这 意味 痢 他 们 需要 多 编 与 一 些 关 ， 
而 且 和 需要 提前 进行 思考 。 但 是 ， 一 般 来 说 ， 在 问 视 图 传递 数 据 时 ， 强 类 型 视图 模型 
是 优先 选择 的 方法 ， 因 为 这 些 模型 壹 使 开 友 人 员 关 注 进入 和 离开 视图 的 数据 流 。 

与 使 用 字典 相 比 ， 视 图 模型 类 只 不 过 是 将 要 传 入 视图 的 数据 组 织 起 来 的 为 外 一 
种 方式 。 使 用 视图 模型 类 以 后 ， 数 据 不 会 是 黎 瑰 对 和 象 值 的 一 个 集合 ， 而 将 成 为 一 个 
合理 的 分 层 结 构 ， 其 中 每 一 条 数据 部 保留 目 己 的 真实 类 型 。 


1. 视图 模型 类 的 指导 原则 
视图 模型 类 完全 代表 了 要 演 染 到 视图 的 数据 。 类 的 结构 应 该 尽 可 能 与 视图 的 结 
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构 匹 配 。 虽 然 总 是 可 能 实现 一 定 的 重用 (并 且 在 一 定 程度 上 也 建议 这 么 做 )， 但 是 一 
般 来 说 ， 应 该 努力 让 每 个 Razor 视图 模板 有 一 个 专门 的 视图 模型 类 。 

使 用 实体 类 作为 视图 模型 类 是 一 个 常见 的 错误 。 例 如 ， 假 设 数据 模 型 有 一 个 类 
型 为 Customer 的 实体 。 应 该 如 何 同 允许 编辑 客户 记录 的 Razor 视图 传递 数据 呢 ? 你 
可 能 会 想 把 要 编辑 的 Customer 对 和 象 的 引用 传递 给 视图 。 这 或 许 是 一 个 好 的 解决 方 
案 ， 但 最 终 取 决 于 视图 的 实际 结构 和 内 容 。 例 如 ， 如 果 视 图 允许 修改 客户 的 国家 ， 
那么 可 能 需要 问 视 图 传递 一 个 国家 列表 ， 供 从 中 选择 。 一 般 来 说 ， 理 想 的 视图 模型 
类 应 该 与 下 面 的 类 相似 : 

public class CustomerEditViewModel 

public Customer CurrentCustomer { get; set; |} 

public IList<Country> AvailableCountries { get; set; } 

} 

可 以 接受 把 实体 模型 直接 传递 给 视图 的 唯一 一 种 情况 是 确实 有 一 个 CRUD 视 
图 的 时 候 。 但是， 坦白 讲 ， 纯 粹 的 CRUD 视图 如 今 只 存在 于 教程 和 总 结 文章 中 。 

我 建议 始终 从 公共 基 类 开始 创建 视图 模型 类 。 下 面 的 代码 可 作为 一 个 简单 有 效 
的 起 点 。 


public class VjewModelBase 
{ 


Public VijewModelBase (string title 三 ) 
{ 
Title = titles 
} 
Public string Title { gqet; set; 上 } 
} 


因为 这 个 类 主要 用 来 建 模 HTML 视图 ， 所 以 必须 全 少 公 开 一 个 Title 属性 ， 用 
来 设置 页 面 的 标题 。 上 只 要 识别 了 应 用 程序 中 的 所 有 页 和 面 所 共有 的 其 他 属性 ， 残 可 以 
添加 更 多 属性 。 另 外 ， 好 的 做 法 是 将 议 置 格式 的 方法 放 到 视 岁 模型 基 关 中 ， 而 不 是 
把 相同 的 大 量 C# 代 码 放 到 Razor 视图 中 。 

应 该 让 所 有 的 视图 模型 类 派生 日 ViewModelBase 这 样 的 类 吗 ? 理想 情况 下 ,对 
于 使 用 的 每 个 布局 类 ， 应 该 有 一 个 视图 模型 基 类 。 这 些 视图 模型 类 将 使 用 特定 布局 
所 共有 的 属性 来 扩展 ViewModelBase。 最 后 ， 每 个 基于 特定 布局 的 视图 将 得 到 从 布 
局 的 视图 模型 基 类 所 派生 的 类 的 实例 。 


2. 将 数据 流 集中 到 视图 中 


我 们 来 看 看 下 面 这 段 简单 但 是 仍然 很 重要 的 Razor 代码 。 代 码 中 主要 包含 一 个 
DIV 元 素 ， 它 在 内 部 泻 染 当前 时 间 ， 并 提供 了 一 个 供 返回 到 前 一 个 页 面 的 链接 . 


Gmodel IndexViewModel 
Qusing Microsoft .Extensions.Options; 
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Qinject IOptions<GlobalConfig> Settings 
<div> 
<span> 
dDateTime.Now.ToString (Settings.Value.DateFormat) 
</span> 
<a href="@Model .ReturnUrl">Back</a> 
</div> 


数据 不 只 从 一 个 地 方 流 入 视图 。 实 际 上 ， 数 据 有 三 个 不 同 的 来 源 ， 视图 模型 
(Model 属性 )、 注 入 的 依赖 (Settings 属性 ) 和 对 系统 的 DateTime 对 象 的 静态 引用 。 虽 
然 这 种 方法 不 会 损害 视图 功能 ， 但 是 在 包含 几 百 个 视图 并 且 非 常 复杂 的 大 型 应 用 程 
序 中 ， 处 理 起 来 可 能 问题 多 多 。 

在 Razor 视图 中 ， 应 该 避免 生 接 使 用 评 态 引用 以 及 DI 注入 的 引用 (ASPNET Core 
的 骄傲)， 因 为 这 些 引 用 会 增加 数据 的 市 党。 如 果 想 了 解 如何 构 建 可 维护 的 视图 ， 那 
么 应 该 致力 于 只 给 每 个 视 匈 一 种 获取 数据 的 方式 : 视图 模型 类 。 这 样 ， 如 果 视 图 需 
要 前 态 引 用 或 全 局 引用 ， 那 么 只 需要 在 视图 模型 关中 添加 这 些 属性 。 特 别 是 ， 当 前 
时 间 就 可 以 作为 另 一 个 属性 添加 到 ViewModelBase 超 类 中 。 


5.3.3 通过 DI 系统 注入 数据 


在 ASPNET 中 ， 可 以 将 DI 系统 中 注册 的 任何 类 型 的 实例 注入 视图 中 。 这 是 通 
过 @inject 指令 实现 的 。 如 前 所 述 ，@inject 指令 添加 了 另 一 个 渠道 ， 数 据 通 过 它 可 
以 流入 视图 。 从 长 远 来 看 ， 这 可 能 成 为 维护 代码 时 的 一 个 问题 。 

但 是 ， 对 于 短期 应 用 程序 或 者 仅仅 作为 一 种 快捷 手段 ， 将 外 部 引用 注入 视图 中 
是 一 种 完全 文 持 的 功能 。 不 管 其 他 的 设计 可 能 有 什么 样 的 好 处 ， 有 一 点 需要 知道 : 
ViewData 字典 和 人 @inject 指令 结合 起 来 时 , 为 从 Razor 视图 中 获取 需要 使 用 的 任何 数 
据 提 供 了 一 种 强大 的 、 极 为 快速 的 方法 。 我 自己 不 采用 这 种 方法 ， 也 不 鼓励 这 么 做 ， 
但 是 ASPNET Core 确实 文 持 这 种 方法 ， 它 也 确实 能 起 到 效果 。 


54 Razor 由 加 

在 经 典 ASPNET MVC 中 , 通过 直接 使 用 URL 是 无 法 引用 Razor 模板 的 。URL 
可 用 来 链接 到 静态 HTML 页 和 面 或 某 个 控制 器 操作 方法 生成 的 HTML 输出 .ASPNET 
Core 也 不 例外 。 但 是 ， 从 ASPNET Core 2.0 开始 ， 提 供 了 一 个 新 的 功能 :Razor 页 
面 。 它 允许 直接 通过 URL 调用 Razor 模板 ， 而 不 需要 任何 控制 器 的 协调 。 
5.4.1 引入 Razor 页 面 的 理由 


有 时 , 一些 控 制 右 方法 只 是 价 单 地 提供 一 些 相 当 姜 态 的 标记 。 标准 网 站 的 About 
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Us 或 Contact Us 页 和 耐 就 是 规范 的 例子 。 我 们 看 看 下 和 耐 的 代码 。 


public class HomeController 


{ 
Public IActionResult About () 
return Viewt(}); 
} 


Public IActionResult ContactUs ( ) 
return View(); 
} 

} 

可 以 看 到 ， 没 有 数据 从 控制 絮 传 入 视图 ， 实 际 视图 中 也 不 期 望 有 洽 染 逻辑 。 为 
什么 要 为 这 样 一 个 简单 的 请 求 使 用 筛选 器 和 控制 器 呢 ? 实际 上 Razor 页 面 就 能 满足 
目的 。 

使 用 Razor 由 和 面 的 为 外 一 个 场景 是 ， 它 们 在 一 定 程度 上 降低 了 熟练 的 ASPNET 
编程 的 门槛 。 下 面具 体 说 明 。 


5.4.2 Razor 页面 的 实现 


当 需 要 的 只 比 静 态 HTML 复杂 一 点 ， 而 用 不 到 完整 的 带 有 全 部 基础 结构 的 
Razor 视图 时 ， 使 用 Razor 页 面 能 够 省 去 控制 器 的 成 本 。Razor 页 面 可 以 支持 一 些 相 
当 高 级 的 编程 场景 ， 例 如 访问 数据 库 、 传 递 表单 、 验 证 数据 等 。 但 是 ， 如 果 需 要 这 
样 的 功能 ， 为 什么 不 使 用 一 个 普通 的 页 面 呢 ? 


1. @page 指令 


下 面 的 代码 显示 了 一 个 简单 的 但 是 可 以 工作 的 Razor 页 面 的 源 代码 。Razor 代 
码 极其 简单 ， 这 并 不 是 巧合 。 


Qpage 
@ 1{ 

Var title = "Hello, World!™; 
} 


<html> 
<head> 
<title>@title</title> 
</head> 
<body> 
< 1 -一 Some relatively static markup 一 一 > 
</body> 
</html> 


Razor 页 和 面 就 像 一 个 无 布局 的 Razor 视图 ， 但 是 它们 使 用 的 根 指令 是 @page。 
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Razor 页 面 完整 文 持 Razor 语法 ， 包 括 @inject 指令 和 C#i 语 言 。 

@page 指令 对 于 让 Razor 视图 成 为 一 个 Razor 外 而 全 天 和 车 要 ， 因 为 这 个 指令 在 
被 处 理 后 ， 告 诉 ASPNET Core 基础 结构 将 请 求 作为 一 个 操作 处 理 ， 即 使 该 请 求 没 
有 绑 定 到 任何 控制 器 。 需 要 注意 ，@page 指令 会 影响 其 他 支持 的 指令 的 行为 ， 所 以 

必须 是 页面 中 的 第 一 条 Razor 指令 。 


2. 文 持 的 文件 夹 


Razor 页 面 是 普通 的 .cshtml 文件 ,保存 在 新 增 的 Pages 文件 夹 中 。Pages 文件 夹 
pe 在 Pages 文件 夹 中 ， 可 以 有 任意 多 级 子 目 录 ， 每 个 目录 中 都 可 以 包 
含 Razor 页 面 。 换 句 话 说，Razor 贝 向 的 位 置 与 文件 在 文件 系统 目录 中 的 位 置 非常 
pep 
不 能 将 Razor 页 面 放 到 Pages 文件 夹 之 外 。 


3. 映射 到 URL 


用 来 调用 Razor 页面 的 URL 依赖 于 对 应 文件 在 Pages 文件 夹 中 的 物理 位 置 以 及 
文件 的 名 称 。 如 果 文 件 名 为 about.cshtml, 正好 位 于 Pages 文件 夹 下 ,那么 可 通过 /about 
访问 该 文件 。 类 似 地 ， 如 果 文 件 名 为 contact.cshtml， 位 于 Pages/Misc 下 ， 有 
/misc/contact 访问 。 一 般 映 射 规则 为 : 取得 Razor 页 面 文件 相对 于 Pages 的 路 径 ， 然 
后 去 挥 文件 扩展 名 。 

如 果 应 用 程序 中 正好 有 一 个 MiscController 类 ， 类 中 有 一 个 Contact 操作 方法 ， 
会 发 生 什 么 ”此 时 ， 当 调用 /misc/contract 这 个 URL 时 ， 会 通过 MiscController 类 还 
是 Razor 页 面 运行 它 ? 答案 是 控制 器 将 会 取胜 。 

还 要 注意 ， 如 果 Razor 页 面 的 名 称 是 index.cshtml， 那 么 在 URL 中 也 可 以 去 挥 
index 这 个 名 称 ， 即 通过 /ipndex 和 /都 可 以 访问 该 页面 。 


5.4.3 从 Razor 页 面 提 交 数 据 


Razor 页 面 的 另 一 个 实用 场景 是 该 页 面 仅 仅 用 来 提交 表单 。 对 于 基本 的 基于 表 
单 的 页 面 ， 如 “联系 我 们 ”页 面 ， 这 种 功能 十 分 理想 。 


1. 在 Razor 页 面 中 添加 表单 


下 面 的 代码 显示 了 一 个 包含 表单 的 Razor 页 面 ， 并 演示 了 如 何 初始 化 表单 并 提 
交 其 数据 。 


Qinject IContactRepository ContactRepo 
Qfunctions { 
[BindPropertyl| 
Public ContactIinfo Contact 1{ get; set; } 
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Public void IActionResult OnGet () 
L 
Contact.Name = ™" 
Contact.Email = "™e: 


return Page (); 


} 


Public void IActionResult OnPost () 
{ 
ift (Modelstate.IsValid) 
{ 
ContactRepo.Add (Contact)}); 
return RedirectToPage () 7 
} 


return Page(); 
} 


<html> 
<body> 
<p>Let us call You back!</p> 
<div asp-validation—summary="All"></div> 
<form method="POST"> 
<div>Name: <input asp-for="ContactInfo.Name™" /></div> 
<div>Email: <input asp-for="ContactInfo.Email™ /></div> 
<button type="submit">SEND</button> 
</form> 
</body> 
</html> 
该 由 和 面 被 拆 分 成 两 个 主要 的 部 分 : 标记 区 和 代 人 码 区 。 标 记 区 是 普通 Razor 视图 ， 
具备 Razor 视图 的 所 有 功能 ， 包 括 标 记 帮 助 程序 和 HTML 帮助 程序 。 代 但 区 包含 的 
代 但 用 来 初始 化 页 和 面 及 处 理 提交 的 数据 。 


2. 初始 化 表单 


@functions 指令 作为 页 面 中 的 所 有 代码 的 容器 ， 通 第 由 两 个 方法 构成 : OnGet 
和 OnPost。 前 者 用 于 初始 化 标记 的 输入 元 素 ， 后 者 用 于 处 理 表单 提交 的 任何 内 容 。 

HTML 输入 元 素 与 代码 元 素 之 间 的 绑 定 是 使 用 模型 绑 定 层 完成 的 。 用 BindProperty 
特性 装饰 的 Contact 属性 在 OnGet 方法 中 初始 化 ， 其 值 将 泻 染 为 HIML。 当 表单 数 
据 提 交 后 ， 该 属性 将 (通过 模型 绑 定 ) 包 含 提 交 的 值 。 


3. 处 理 表单 的 输入 


OnPost 方法 可 使 用 ModelState 属性 来 检 答 销 误 , 整个 验证 基础 结构 的 工作 方式 
与 在 控制 器 中 一 致 。 如 果 没 有 发 现 错误 ， 就 要 处 理 提交 的 值 。 如 果 发 现 错误 ， 就 调 
用 Page0 函 数 返回 页 面 ， 这 将 导 禾 对 同一 个 URL 发 出 GET 请 求 。 
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处 理 表 单 的 输入 实际 上 意味 痢 访问 一 个 数据 库 。 可 以 通过 应 用 程序 的 DbContext 
对 象 直接 访问 这 个 数据 库 ， 也 可 以 通过 一 些 专门 的 存储 库 进 行 访 问 。 在 这 两 种 情况 
下 ;必须 通过 DI 在 幢 面 中 注入 对 工具 的 引用 。 类 似 地 , 可 以 使 用 @inject 指令 让 Razor 
页 面 的 上 下 文 能 够 使 用 任何 必要 的 信息 。 


重要 / 


如 果 查 看 Razor 页 面 的 文档 ， 会 发 现 一 些 用 于 更 高 级 场 昌 的 选项 和 工具 。 但 是 
坦白 说 ，Razor 页 面 的 真正 威力 在 于 能 够 快速 尾 盖 基本 场景 。 超 过 这 个 程度 ，Razor 
页 面 的 复杂 度 与 控制 器 的 复杂 度 就 相差 无 几 了 .而 控制 器 能 够 提供 更 深 的 代码 分 层 ， 
以 及 关注 点 的 更 深入 隔离 。 在 比 这 里 讨论 的 场景 更 复杂 的 地 方 ， 使 用 Razor 页 面 而 
不 是 控制 器 就 只 是 一 种 个 人 倾向 问题 了 。 


5.5 人 小结 


视图 是 Web 应 用 程序 的 基础 。 在 ASPNET Core 中 , 视图 是 处 理 模板 文件 (通常 
是 Razor 模板 文件 ) 并 将 其 与 调用 方 (通常 是 控制 桌 方 法 ) 提 供 的 数据 混合 在 一 起 的 结 
果 。 在 本 半 中 ， 我 们 首先 讨论 了 视图 引擎 的 架构 ， 然 后 深入 讨论 了 Razor 视图 有 的 渔 
染 。 之 后 ， 我 们 对 比 了 几 种 回 视 图 传递 数据 的 方法 。 最 后 介绍 了 了 Razor 页 面 ， 它 们 
对 于 快速 组 织 极为 和 休 单 的 基本 视图 很 有 帮助 ， 也 可 以 作为 一 种 工具 ， 帮 助 从 男 外 一 
种 角度 学 习 ASPNET Core 中 的 Web 编程 。 

本 草包 含 许多 Razor 代码 段 。Razor 是 一 种 标记 语言 ， 其 语法 与 HTML 相似 ， 
但 是 允许 添加 众多 扩展 和 特定 的 功能 。 第 6 章 将 介绍 Razor 的 语法 。 


人 应 该 坦然 面 对 厄 运 、 自 己 犯 下 的 错误 、 自 己 的 良心 等 一 类 的 东西 。 不 然 
呢 ? 要 对 抗 的 还 有 什么 呢 ? 
一 一 约瑟夫 。 康 拉 德 , 《阴影 线 》 


ASPNET Core 应 用 程序 通 第 但 并 非 总 是 由 控制 左 构 成 ; 控制 器 方法 通常 但 并 非 
总 是 返回 ViewResult 对 象 作 为 处 理 结果 。 之 后 ， 操 作 调 用 程序 系统 组 件 处 理 操 作 结 
果 ， 生 成 实际 的 啊 应 。 如 果 操 作 结 果 是 一 个 ViewResult 对 象 ， 束 会 局 动 视 图 引擎 ， 
生成 一 些 HIML 标记 。 视 网 引擎 被 设计 为 使 用 给 定 文件 夹 结构 中 的 模板 ， 并 问 其 填 
入 一 些 提 供 的 数据 。 模 板 的 表达 方式 以 及 回 模 板 注 入 数据 的 方式 取决 于 视图 引擎 组 
件 的 内 部 实现 ， 以 及 视图 引擎 在 生成 HTML 时 理解 并 解析 的 内 部 标记 语言 。 

ASPNET Core 目 市 一 个 默认 的 视图 引擎 : Razor 视图 引擎 。Razor 是 一 种 标记 
语言 ， 用 来 定义 应 用 程序 的 HIML 视图 的 布局 。 在 前 面 的 草 节 中 ,我 们 已 经 看 到 了 
Razor 语言 的 一 些 例子 。 本 章 将 系统 而 全 和 面 地 介绍 Razor 的 语言 元 素 。 


6.1 语法 元 素 


Razor 文件 是 一 个 文本 文件 ， 包 含 两 个 主要 的 语法 项 : HTML 表达 式 和 代码 表 
达 式 .HTML 表达 式 逐 字母 发 出 ; 代码 表达 式 则 被 求 值 , 并 且 它 们 的 输出 将 与 HTML 
表达 式 合并 到 一 起 。 代 人 码 表 达 式 指 的 是 某 种 预定 义 编程 语言 的 语法 。 

Razor 文件 的 扩展 名 标识 了 使 用 的 编程 语言 。 默 认 情况 下 ， 扩 展 名 为 .cshtml， 用 
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于 表达 式 的 编程 语言 为 C#。 无 论 选 择 什 么 编程 语言 ，@ 字 符 总 是 表明 Razor 代码 表 
达 式 的 开始 位 置 。 


6.1.1 ”处理 代码 表达 式 


在 第 5 章 , 我 们 看 到 了 Razor 解析 器 如 何 处 理 源 代码 , 以 及 如 何 生成 静态 HTML 
表达 式 和 动态 代 公 表达 式 的 有 友 列 表 。 代 人 码 表 达 式 可 以 是 在 行内 发 出 的 一 个 直接 值 
(例如 变量 或 普通 表达 式 )， 也 可 以 是 一 个 复 淋 的 语句 ， 由 循环 和 条 件 等 控制 流 元 到 
构成 。 

有 意思 的 是 ， 在 Razor 中 ， 忆 是 需要 指出 代码 段 在 什么 地 方 开 始 。 之 后 ， 内 部 
解析 咒 将 使 用 所 选编 程 语言 的 语法 来 确定 代码 表达 式 何 时 结束 。 


1. 内 联 表达 式 
考虑 下 面 的 例子 : 


<div> 
QCultureInfo.CurrentUICulture.DisplayName 
</div> 


在 这 段 代码 中 ，CultureInfo.CurrentUICulture.DisplayName 表达 式 将 被 求 值 ， 得 
到 的 输出 将 发 出 到 输出 流 中 。 下 和 面 是 男 外 一 个 内 联 表 达 式 的 例子 : 
@1{ 


Var message = "Hello™} 


} 


<d1iv> 
dmessage 
</div> 


(@message 表达 式 发 出 message 变量 的 当前 值 。 不 过 ,在 上 面 这 个 代码 段 中 ,我 
们 看 到 了 另外 一 个 语法 元 素 : @{...} 代 人 码 块 。 


2. 代码 块 


代码 块 中 允许 使 用 多 行 语句 , 包括 声明 和 计算 .@4...} 代 码 块 的 内 容 被 假定 为 代码 ， 
除非 其 内 容 被 封 疙 在 一 个 标记 标签 中 。 标 记 标 签 主要 是 HIML 标签 ， 但 是 原则 上 ， 如 
条 在 特定 场景 中 有 意义 的 话 ， 甚 全 可 以 使 用 非 HTML 的 目 定义 标签 。 考虑 下 和 面 的 例子 : 
@1{ 
Var culture = CultureInfo.CurrentUICulture.DisplavyName,; 


Your culture is fculture 


} 
在 这 个 例子 中 ， 代 码 块 需要 包含 代码 和 静态 标记 。 假 设想 要 友 送 给 浏览 规 的 标 
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记 是 纯 文本 , 日 文本 没有 包含 在 HTML 元 取 内 (包括 没有 视觉 提示 的 元 系 , 如 SPAN)。 
上 和 面 代码 的 效果 是 ,解析 此 将 笃 试 根据 当前 编程 语言 的 语法 来 解析 文本 “Your culture 
is ...”。 这 很 可 能 导致 一 个 编译 错误 。 下 面 显示 了 如 何 重 写 上 面 的 代码 。 


@1{ 
Var culture = CulturelInfo.currentUICulture.DisplayName; 
<text>Your culture is @culture</text> 


} 
<tex 忆 标签 可 用 来 标记 某 些 静 态 文本 将 被 逐 字 母 泻 染 ， 而 响应 中 不 会 泻 染 其 周 
围 的 标记 元 素 。 


3. 语句 


任何 Razor 代码 段 都 能 与 普通 标记 相 混 合 ， 即 使 代码 段 中 包含 控制 流 语句 ， 如 
if/else 或 forforeach。 和 下面 这 个 简单 的 例子 显示 了 如 何 构 建 一 个 HIML 表格 : 


<body> 
<h2>My favorite cities</h2> 
<hr /> 
<table> 
<thead> 
<th>City</th> 
<th>Country</th> 
<th>Ever been there?</th> 
</thead> 
aforeach (var city in Model.Cities) f{ 
<t 工 > 
<td>@city.Name</td> 
<td>@city.Country</td> 
<td>@city.Visited 2?"Yes™ :"No"</td> 
</tr> 
} 
</table> 
</body> 


注意 ， 放 在 源 代码 中 间 的 结束 花 括号 (可 以 在 @foreach 行 中 看 到 ) 被 人 
地 识别 和 人 解释 了 。 

通过 使 用 圆 括 号 ， 可 在 同一 个 表达 式 中 合并 多 个 记 写 ， 如 标记 和 代 伺 : 

<p> @ ("Welcome, ™ + user) </p> 

创建 的 任何 变量 都 可 在 以 后 获取 和 使 用 ， 束 像 代 人 码 属于 一 个 代码 块 一 样 。 

4. 输出 编码 

Razor 处 理 的 任何 内 容 都 会 被 目 动 编 翁 ， 这 样 一 来 ， 你 目 己 不 需要 多 做 工作 ， 
得 到 的 HIML 输出 不 极为 安全 ， 能 够 抵御 XSS 脚本 注入 。 牢 记 这 一 点 并 避免 显 式 
编 介 输出， 因为 这 可 能 导致 文本 被 两 次 编 伺 。 


析 堪 正确 
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但 是 ， 在 菏 些 情况 下 ， 代 码 需 要 发 出 未 编码 的 HTML 标记 。 此 时 ， 需 要 使 用 
Html.Raw 帮助 程序 方法 。 下 面 显 示 了 如 何 使 用 该 方法 。 


Compare this QHtml .Raw ("<b>Rold text</b>") 
to the following: @("<b>Bold text</b>") 


Html 对 象 从 何 而 来 呢 ? 从 技术 上 讲 ， 它 被 称 为 HIML 帮助 程序 ， 是 所 有 Razor 
视图 的 基 类 RazorPage 上 的 一 个 预定 义 属性 。 稍 后 将 看 到 , Razor 中 提供 了 许多 有 意 
思 的 HIML 帮助 程序 。 


5. HTML 帮助 程序 


HTML 帮助 程序 是 HtmlHelper 关 的 一 个 扩展 方法 。 抽 象 来 讲 ，HTML 帮助 程序 
只 不 过 是 一 个 HIML 工厂 。 在 视图 中 调用 该 方法 ; 从 提供 给 该 方 法 的 输入 参数 (如 
果 有 ) 生 成 的 一 些 HIML 将 被 插入 视图 中 。 在 内 部 ，HIML 帮助 程序 只 是 将 标记 累 
加 到 一 个 内 部 的 缓冲 区 ， 然 后 输出 这 些 标 记 。 视 图 对 象 通 过 属性 名 Html 包含 
HtmlHelper 类 的 一 个 实例 。 
ASPNET Core 提供 了 一 些 自 带 的 HTML 帮助 程序 , 包括 CheckBox、ActionLink 
和 TextBox。 表 6-1 给 出 了 常用 的 HTML 帮助 程序 。 


表 6-1 利用 的 HTML 帮助 程序 方法 
BeginForm、BeginRouteForm 表单 返回 一 个 表示 HTML 表单 的 内 部 对 象 , 系 
统 使 用 该 对 象 来 泪 染 <form> 标 等 
EndForm 一 个 void 方法 ， 天 闭 </form> 标 等 
CheckBox、 CheckBoxFor 输入 返回 复 选 框 输入 元 素 的 HIML 字符 串 
Hidden、HiddenFor 返回 隐藏 炳 入 元 系 的 HIML 字符 串 
i 入 返回 密码 输入 元 素 的 HTML 字符 串 
RadioButton、RadioButtonFor 输入 返回 单 选 按钮 输入 元 素 的 HIML 了 衬 和 作品 
| 返回 文本 输入 元 素 的 HIML 字符 申 


Nn, 
蔬 


Password、 PasswordFor 


TextBox、 TextBoxFor 
Label 、LabelFor 


ActionLink、 RouteLink 


DropDownList、 DropDownListFor 返回 下 拉 列 表 的 HIML 字符 串 
ListBox、 ListBoxFor 返回 列表 框 的 HTML 了 衬 付 串 
TextArea、TextAreaFor 返回 文本 区 域 的 HIML 文 持 
ValidationMessage、 返回 验证 消 居 的 HTML 字符 串 
ValidationMessageFor 

ValidationSummary 验证 返回 验证 总 结 消 奶 的 HTML 字符 串 
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举 个 例子 ， 下 面 看 看 如 何 使 用 HTML 帮助 程序 来 创建 一 个 文本 框 ， 文 本 框 中 的 
文本 将 通过 代 但 填 入 。 


daHtml .TextBox ("LastName™", Model] .LastName) 


每 个 HTML 帮助 程序 都 有 许多 重 载 ,用 来 指定 特性 值 和 其 他 相关 的 信息 。 例 如 ， 
下 面 这 个 重 载 的 TextBox 使 用 class 特性 指定 了 文本 框 的 样式 : 
QHtml .TextBox ("LastName", 


Model .LastName, 
new Dictionary<String, Object>{{"class", "myCoolTextBox"™}}) 


在 表 6-1 中 , 显示 了 许多 xxxFor 帮助 程序 。 它 们 与 其 他 帮助 程序 有 什么 区 别 呢 ? 
xxxFor 帮助 程序 与 基础 版 本 的 区 别 在 于 ， 它 只 接受 一 个 Lambda 畏 数 作为 参数 ， 如 
下 所 示 。 


QHtm]l .TextBoxFor (model => model .LastName, 
new Dictionary<SsString, Object>{{"class", "myCoolTextBox™}}) 


对 于 文本 杠 ，Lambda 表达 式 指出 了 输入 字段 中 要 显示 的 文本 。 当 用 来 填充 视 
图 的 数据 被 分 组 到 一 个 模型 对 象 中 时 ，xxxFor 版 本 特别 有 用 。 在 这 种 情况 下 ， 视 图 
结果 读 取 起 来 更 加 清晰 ， 并 且 是 强 类 型 的 。 

使 用 HTML 帮助 程序 的 优 缺 点 都 很 明显 。 它 们 一 开始 是 作为 HTML 子 例 程 引 
入 的 : 调用 它们 ， 传 入 参数 ， 然 后 获取 期 望 的 标记 。HTML 帮助 程序 越 复 杂 ， 就 要 
编写 越 多 的 C# 代 码 来 传递 参数 ， 通 常 形 成 深层 的 参数 图 。 在 某 种 程度 上 ，HTML 
帮助 程序 隐藏 了 演 染 复杂 标记 的 复杂 性 。 但 是 ， 与 此 同时 ， 因 为 标记 的 结构 被 隐藏 
了 , 开发 人 员 就 无 法 了 解 其 结构 , 而 只 能 把 标记 作为 一 个 黑 盒 来 使 用 。 甚 全 使 用 CSS 
来 设置 一 段 内 部 标记 的 样式 都 需要 仔细 设计 ， 因 为 必须 在 API 中 公开 CSS 属性 。 

尽管 ASPNET Core 完全 文 持 HIML 帮助 程序 ， 但 是 相 比 几 年 前 ， 使 用 它们 的 
吸引 力 已 经 大 大 下 降 。ASP. NET Core 提供 了 标记 帮助 程序 (后 面 将 介绍 ) 来 作为 一 种 
附加 的 工具 , 能 够 以 灵活 而 又 具有 表现 力 的 方式 泻 染 复杂 的 HTML。 从 我 个 人 来 讲 ， 
我 近来 很 少 使 用 HTML 帮助 程序 ， 只 有 一 个 例外 : CheckBox 帮助 程序 。 


6. 布尔 值 与 复 选 框 的 特殊 情况 


假设 在 HIML 表单 中 有 一 个 复 选 枉 。 标 准 登 录 表 单 中 的 Remember me 复 选 框 
是 一 个 很 好 的 例子 。 如 果 不 使 用 CheckBox 帮助 程序 ， 那 么 需要 使 用 下 面 的 普通 
HIML: 


<input name="rememberme™" type="CheckBox™ /> 
按照 HTML 标准 ， 如 打 选 中 该 复 选 枉 ， 浏 览 需 将 握 交 下 面 的 值 : 


rememberme=on 
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如 条 没 有 选中 复 选 框 ， 那 么 输入 字段 将 被 忽略， 并且 不 会 发 送 。 此 时 ， 和 模型 绑 
定 如 何 处 理 提交 的 数据 呢 ? 模型 绑 定 层 将 on 理解 为 tue， 但 是 如 果 RememberMe 
名 称 没 有 提交 值 ， 它 就 做 不 了 什么 。CheckBox 帮助 程序 会 默默 地 向 RememberMe 
名 称 附 加 一 个 INPUT 隐藏 元 素 ， 并 将 其 设置 为 false。 如 条 选 中 了 复 选 枉 ， 则 将 为 
同一 个 名 称 提 区 两 个 值 ， 不 过 在 这 种 情况 下 ， 模 型 绑 定 层 会 选择 第 一 个 值 。 

除了 这 种 特殊 的 情况 以 外 ， 使 用 HTML 帮助 程序 而 不 是 普通 HTML 或 更 好 的 
标记 帮助 程序 就 主要 是 一 种 个 人 偏好 了 。 


7. 注释 


最 后 要 介绍 的 是 注释 。 在 生产 代码 中 可 能 不 需要 注释 ， 但 是 在 开发 代码 中 肯定 
需要 它们 ， 在 Razor 视图 中 可 能 也 需要 使 用 注释 。 在 使 用 @{..} 的 多 行 代码 段 中 工 
作 时 ， 可 使 用 相应 语言 的 语法 来 添加 注释 。 当 需要 注释 一 段 标记 时 , 可 使 用 @*..…*@ 
语法 。 如 下 所 示 : 


<div> Some Razor markup </div> 


*@ 


Visual Studio 能 够 检测 到 注释 ， 并 用 配置 的 颜色 显示 它们 。 
6.1.2 布局 模板 


在 Razor 中 ， 布 局 模板 扮演 了 母 版 页 的 角色 。 布 局 模板 定义 了 视图 引擎 在 任何 
映射 的 视图 中 泻 染 的 骨架 ， 使 得 网 站 的 对 应 部 分 有 了 一 致 的 外 观 和 感觉 。 

通过 设置 父 视图 类 的 Layout 属性 ， 每 个 视图 都 可 以 定义 自己 的 布局 模板 。 可 
以 把 布局 设置 为 便 编 码 的 文件 ， 或 者 设置 为 对 运行 时 条 件 求 值得 到 的 任何 路 径 。 
在 第 5 章 看 到 ， 使 用 ViewStart.cshtml 文件 可 为 Layout 属性 赋值 一 个 默认 属性 ， 从 
而 为 所 有 视图 定义 一 个 默认 的 图 形 模板 。 


1. 使 用 布局 的 指导 原则 


从 技术 上 讲 ， 布 局 模板 与 视图 (或 分 部 视图 ) 没 什么 区 别 ， 视 图 引擎 将 按照 相同 
的 方式 解析 和 人 处理 布局 模板 的 内 容 。 但 是 ， 与 大 部 分 视图 (和 所 有 分 部 视图 ) 不 同 的 
是 ， 布 局 模板 是 一 个 完整 的 HTML 模板 ， 以 <html> 开 头 ， 以 </html> 结 束 。 


二 | 注意 : 

视图 并 不 是 必须 把 布局 设置 为 一 个 不 同 的 资源 。 最 终 ，Razor 引擎 将 按照 相同 
的 方式 处 理 布局 和 常规 视图 ， 这 意味 着 可 以 在 一 个 HTML 元 素 中 封装 一 个 完整 的 
HTMIL 页 面 视 图 模板 。 
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因为 布局 文件 是 一 个 完整 的 HTML 模板 ， 所 以 应 该 包含 一 个 完整 的 HEAD 块 ， 
在 其 中 提供 元 信息 、favicon 以 及 常用 的 CSS 和 JavaScript 文件 。 把 脚本 放 到 HEAD 
节 还 是 视图 体 的 末尾 由 你 目 己 决定 。 模 板 体 定义 了 所 有 派生 视图 的 布局 。 典 型 的 布 
局 模板 包含 一 个 页 眉 、 一 个 页 脚 ， 还 可 能 包含 一 个 边栏 。 这 些 元 素 中 显示 的 内 容 将 
被 所 有 视图 继承 ， 它 们 可 被 静态 地 设置 为 普通 的 本 地 化 文本 ， 或 者 绑 定 到 传 入 的 数 
据 。 稍 后 将 看 到 ， 布 局 页 面 可 接受 外 部 传 入 的 数据 。 

在 现实 应 用 中 ， 应 该 有 多 少 个 布局 文件 呢 ? 

这 很 难 从 普遍 适用 的 角度 来 讲 。 当 然 ， 你 可 能 至 少 需 要 有 一 个 布局 。 但 是 ， 如 
果 所 有 的 视图 都 是 完整 的 HTML 视图 ， 那 么 没有 布局 也 是 可 以 的 。 在 决定 布局 时 ， 
建议 采用 的 一 个 规则 是 ， 对 于 网 站 的 每 个 宏观 区 域 ， 都 有 一 个 布局 。 例 如 ， 可 以 让 
主页 有 一 个 布局 ， 然 后 可 以 有 完全 不 同 的 内 部 页 面 。 内 部 页 和 面 的 数量 取决 于 这 些 页 
面 如 何 分 组 。 如 果 应 用 程序 需要 有 一 个 后 端 办 公 系 统 ， 让 管理 员 用 户 输入 数据 和 配 
置 ， 那 么 可 能 需要 为 其 使 用 另外 一 个 布局 。 


在 任何 视图 中 ， 在 引用 图 片 、 脚 本 和 样式 表 等 资源 时 ， 都 建议 使 用 波浪 号 运算 
符 (~) 来 指 代 网 站 的 根 目 录 。 在 ASPNET Core 中 ,Razor 引擎 会 自动 扩展 波浪 号 运算 
符 。 但 是 要 注意 ， 只 有 在 Razor 引擎 解析 的 代码 块 中 ， 波 浪 号 才能 起 到 这 种 作用 。 
在 普通 的 HTML 文件 ( 带 有 .html 扩展 名 ) 中 ， 以 及 Razor 文件 的 所 有 <script> 元 素 中 ， 
波浪 号 是 不 起 作用 的 .这 时 ,要 么 将 路 径 表 示 为 一 个 代码 块 ,要 么 使 用 一 些 JavaScript 
技巧 来 修复 该 URL. 


2. 问 布局 传递 数据 


开发 人 员 在 编程 时 只 会 引用 视图 及 其 视图 模型 。 在 经 典 ASPNET 中 ,Controller 
类 的 View 方法 还 有 一 个 重 载 ， 用 于 通过 代码 设置 布局 。ASPNET Core 中 没有 提供 
这 个 重 载 方法 。 当 视图 引擎 判断 出 被 演 染 的 视图 有 一 个 布局 时 ， 将 首先 解析 布局 的 
内 容 ， 然 后 与 视图 模板 合并 。 

布局 可 以 定义 自己 期 望 收 到 的 视图 模型 的 类 型 ， 但 是 如 果 它 真正 收 到 了 任何 东 
西 ， 也 只 会 是 传递 给 实际 视图 的 视图 模型 对 象 。 因 此 ， 理 想 情 况 下 ， 布 局 视图 的 视 
图 模型 必须 是 用 于 视图 的 视图 模型 的 父 类 。 建 议 对 于 计划 使 用 的 每 个 布局 ， 都 定义 
一 个 专门 的 视图 模型 基 类 ， 并 从 该 基 类 派生 具体 的 视图 模型 类 来 用 于 实际 的 视图 。 
如 表 6-2 所 示 。 


129 


130 


第 中 部 分 ASPNET MVC 应 用 程序 模型 


表 6-2 布局 和 视图 模型 类 


视图 模型 布局 描述 
HomeLayoutViewModel HomeLayout HomeLayout 模板 的 视图 模型 
InternalLayoutViewModel InternalLayout InternalLayout 模板 的 视图 模型 


BackofficeLayoutViewModel BackofficeLayout BackofficeLayout 模板 的 视图 模型 


更 好 的 地 方 是 ， 所 有 布局 视图 模型 类 都 将 继承 一 个 父 类 ， 例 如 第 5 章 讨 论 过 的 
ViewModelBase 类 。 
介绍 了 这 些 知 识 后 ， 需 要 知道 的 是 ， 束 像 其 他 任何 视图 一 样 ， 仍 然 可 以 通过 依 


3. 定义 目 定 义 市 


所 有 布局 都 强制 全 少 有 一 个 注入 点 ， 供 注入 外 部 视 岁 内 容 。 这 个 注入 点 就 是 对 
方法 RenderBody 的 调用 。 议 方法 在 用 于 泻 染 布局 和 视 岁 的 视角 基 类 中 定义 。 但 是 ， 
有 时 需要 把 内 容 注入 到 多 个 位 置 。 此 时 ， 需 要 在 布局 模板 中 定义 一 个 或 更 多 个 命名 
节 ， 让 视图 在 这 些 市 中 填写 标记 。 

<body> 

<div Class="page"> 

QRenderBody () 

</div> 

<div lid="footer"> 
QRenderSection ("footer"™.) 

</div> 

</body> 

每 个 节 都 通过 其 名 称 标识 ， 如 果 没 有 标记 为 可 选 ， 那 么 认为 每 个 节 都 是 必须 存 
在 的 。RenderSection 方法 接受 一 个 可 选 的 布尔 参数 ， 用 于 指定 该 市 是 人 奋 是 必要 的 。 
为 了 声明 霖 个 贡 是 可 选 的 ， 可 以 使 用 下 面 的 代码 : 

<div id="footer" > 


QRenderSection ("footer™", false) 
</div> 


下 面 的 代码 在 功能 上 与 前 面 的 代码 等 效 ， 但 是 从 可 读 性 的 角度 看 ， 要 比 前 面 的 
代 但 好 得 多 。 
<div lid="footer"> 


QRenderSsection("footer", required:false) 
</div> 


注意 ，required 不 是 一 个 关键 学 ， 而 只 是 RenderSection 方法 定义 的 形式 参数 的 
名 称 (在 有 IntelliSense 时 ， 它 的 名 称 会 清楚 地 显示 出 来 )。 对 于 日 定义 慷 的 数量 并 没 
有 限制 。 目 定义 节 可 以 用 在 布局 中 的 任 曹 位置 ， 只 要 在 视图 中 填充 以 后 ， 得 到 的 
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HTML 是 有 效 的 即 可 。 

如 果 视 图 模板 不 包含 被 标记 为 required 的 节 ， 则 将 产生 运行 时 异常 。 下 面 显示 
本 如 何在 视图 模板 中 定义 一 个 广 的 内 容 : 

Qsection footer 1{ 


<p>Written by Dino Esposito</p> 
} 


可 以 在 Razor 视图 模板 的 任何 位 置 定义 一 个 节 的 内 容 。 
6.1.3 ”分 部 视图 


分 部 视图 是 一 段 独特 的 HTML， 包 含 在 一 个 视图 内 ， 但 是 被 当成 完全 独立 的 实 
体 来 处 理 。 事 实 上 ， 完 全 针对 某 个 视图 引擎 编写 一 个 视图 ， 而 让 其 引用 的 分 部 视图 
使 用 另 一 个 视图 引擎 ， 是 完全 合法 的 做 法 。 分 部 视图 类 似 于 HTML 子 例 程 ， 主 要 用 
于 两 种 场景 : 编写 可 重用 的 仅 用 于 呈现 UI 的 HTML 片段 ， 以 及 将 复杂 的 视图 分 解 
为 更 小 、 更 易于 管理 的 部 分 。 


1. 可 重用 的 HTML 片段 


原来 引入 分 部 视图 是 为 了 获得 可 重用 的 、 基 于 HTML 的 用 户 界 面部 分 。 但 是 ， 
正如 其 名 称 所 表示 的 ， 分 部 视图 是 一 个 视图 ， 只 不 过 更 小 ， 是 围 纸 一 个 模板 和 一 些 
传 入 或 注入 的 数据 而 构造 的 。 分 部 视 匈 是 可 重用 的 , 但 不 是 一 个 独立 的 HIML 上 户 段 。 

分 部 视图 缺少 业务 逻辑 ， 所 以 无 法 从 可 重用 的 模板 潮 化 成 独立 的 小 组 件 。 换 句 
话说 ， 分 部 视图 仅仅 是 一 个 渔 染 工 具 。 将 横幅 和 且 单 阳 离 开 ， 甚 全 隔离 一 些 表格 和 
边栏 ， 是 很 好 的 做 法 ,但 古 不 能 隔离 目 治 的 Web 部 件 。 对 于 该 目的 ，ASPNET Core 
提供 了 视图 组 件 。 


2. 分 解 复杂 视图 


总 体 来 看 ， 使 用 分 部 视图 将 庞大 而 复杂 的 表单 分 解 为 更 易于 管理 的 部 分 是 更 值 
得 关注 的 用 法 。 大 表单 (尤其 是 包含 多 个 步骤 的 表单 ) 变 得 越 来 越 肖 见 ， 如 条 没有 分 
部 视图 ， 束 很 难 表示 和 人 处理 它 们 。 

从 用 尸体 验 的 角度 来 看 ， 用 选项 卡 来 分 解 非常 大 的 、 包 含 很 多 输入 字段 的 表单 
是 一 种 很 好 的 方法 。 不 过 ， 大 表单 并 不 上 只是 对 于 用 户 来 说 是 个 问题 。 考 虑 下 和 面 这 个 
基于 选项 卡 的 表单 ， 其 中 使 用 了 Bootstrap CSS 类 来 获取 选项 卡 。 

<form class="form-horizontal" id="largeformn 

role="form" method="post" 
action="@Url.Action ("largeform", "sample")"> 


<dliv> 
<1—— Nav tabs 一 一 > 
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<ul] class="nav nav-tabs™" role="tablist"> 
QHtml .Partial ("pv largeform tabs") 
<11 role="presentation” class="active"»> 
<a href="#tabGeneral™" role="tab" data-toggle="tab">General</a> 
</l1i> 
<11 role="presentation"> 
<a href="#tabEmails" role="tab" data-toggle="tab">Emails</a> 
</1i> 
<11 role~="presentation"> 
<a href="#tabPassword" role="tab" data-toggle="tab">Password</a> 
</1i> 
</ul> 


< 一 一 Tab panes 一 一 > 
<div class="tab—content™"> 
<diy role="tabpanel" class="tab-pane active” jd~="tabGeneral"> 
@Html .Partial ("pv largeform general") 
</div> 
<div role="tabpanel]" class="tab-pane" id="tabEmalils"> 
QHtml .Partial ("pv largeform emails"™") 
</div> 
<diyv role="tabpanel™ class="tab-pane”" id="tabPassword"> 
@Html .Partial ("pv largeform password") 
</div> 
</div> 
</div> 
</form> 
如 果 必 须 编写 这 样 的 表单 ， 那 么 不 使 用 分 部 类 的 话 ， 就 必须 把 选项 卡 的 完整 标 
记 散 入 主 视图 中 。 因 为 每 个 选项 卡 痢 可 以 古 一 个 简单 的 视图 ， 所 以 放 到 一 个 位 置 的 
标记 (用 来 写 、 读 和 编辑 ) 的 数量 是 极 大 的 。 在 这 种 上 下 文中 使 用 的 分 部 视图 很 难 重 
用 ， 但 是 它们 能 够 局 效 地 满足 你 的 目的 。 


3. 向 分 部 视图 传递 数据 

视图 引擎 在 处 理 分 部 视图 时 与 处 理 其 他 视图 没有 区 别 。 因 此 ， 分 部 视图 接收 数 
据 的 方式 与 普通 视 图 或 布局 是 一 样 的 ， 可 以 使 用 一 个 强 类 型 的 视图 模型 类 ， 也 可 以 
使 用 字典 。 但 是 ， 如 果 在 调用 分 部 视图 时 不 传递 任何 数据 ， 那 么 分 部 视图 也 将 收 到 
传递 给 父 视图 的 强 类 型 视图 模型 。 


QHtml .Partial ("pv Grid™") 


父 视图 轧 是 与 其 所 有 的 分 部 视图 共 至 视图 字典 的 内 容 。 如 果 问 分 部 视图 蛙 独 传 
递 了 视图 模型 ， 则 不 再 引用 父 视图 的 视图 模型 。 

现在 考虑 一 种 边缘 案例 。 父 视 岁 收 到 了 一 个 数据 对 象 数组 ， 并 过 有 历 该 列表 。 然 
后 ， 将 每 个 数据 对 象 传递 给 一 个 分 部 视图 来 实际 泻 染 。 

Gforeach (var customer in Model .Customers) 

{ 


QHtml .Partial ("pv customer", customer) 


} 
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现在 ，customer 细节 的 演 染 工作 就 完全 交 给 了 pv_customer 视图 ， 这 使 它 成 为 
应 用 程序 中 泻 沫 customer 细 贡 的 唯一 方式 。 目 前 来 看 一 切 都 好 。 但 是 ， 如 果 需 要 问 
分 部 视图 传递 更 多 信息 ， 而 不 只 是 它 收 到 的 customer 数据 对 象 中 包含 的 信息 ， 该 怎 
么 办 ? 可 选项 有 以 下 几 种 。 

e 上 疾 先 ， 可 以 睾 构 涉及 的 类 ,使 分 部 视图 能 够 收 到 所 有 必要 的 数据 。 但 是 ， 这 

种 方法 可 能 损害 该 分 部 视图 的 可 备用 性 。 
e 其 次 ， 可 以 使 用 一 种 匿名 类 型 ， 将 原 数据 对 象 与 额外 的 数据 连接 起 来 。 
e 最后， 可 以 通过 ViewData 传递 任何 额外 的 数据 。 


6.2 Razor 标记 帮助 程序 


使 用 HIML 帮助 程序 时 ,可 通过 编程 来 表示 希望 使 用 的 标记 ， 而 不 用 把 标记 完 
球 写 出 来 。 在 某 种 程度 上 ,HTML 帮助 程序 就 是 一 个 智能 的 HTML 工厂 ， 可 以 配置 
它 来 获得 菏 些 具 体 的 HTML。 在 内 部 ， 帮 助 程序 就 是 C# 代 人 码 ;， 在 外 部 ， 它 们 作为 
C# 代 人 码 段 添加 到 Razor 模板 中 。 

标记 帮助 程序 的 根本 效果 与 HTML 帮助 程序 相同 ， 可 作为 HTML 工厂 ， 但 是 
它们 提供 了 更 人 徇 洁 、 更 目 然 的 语法 。 特 别 是, 不 需要 任何 C# 代 码 就 可 以 使 用 标记 帮 
助 程序 。 


注意 : 
DD 标记 帮助 程序 是 ASPNET Core 独 有 的 功能 。 在 经 典 ASPNET MVC 中 ， 最 接 
近 标 记 帮 助 程序 的 是 使 用 HIML 帮助 程序 ， 或 者 更 好 的 方法 是 使 用 HITML 模板 化 
帮助 程序 . 


6.2.1 ”使 用 标记 帮助 程序 


标记 帮助 程序 是 服务 器 端 代码 ， 可 以 绑 定 到 一 个 或 多 个 标记 元 素 。 当 标记 帮助 
程序 运行 时 ， 能 够 检查 标记 元 素 的 DOM， 甚 至 可 能 改变 生成 的 标记 。 标 记 帮 助 程 
序 是 编译 成 程序 集 的 C# 类 ， 需 要 特殊 的 视图 指令 才能 识别 它们 。 

1. 注册 标记 帮助 程序 

Razor 视图 中 的 @addTagHelper 指令 告诉 解析 器 链接 指定 的 类 , 并 使 用 这 些 类 来 
处 理 未 知 的 标记 特性 和 元 素 。 


QaddTagHelper * YourTagHelperLibrary 
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上 上 面 的 语法 将 YourTagHelperLibrary 程序 集中 的 全 部 类 链接 到 当前 视图 内 ， 作 
为 潜在 的 标记 帮助 程序 。 如果 指定 一 个 类 型 名 , 而 不 是 * 写 , 那么 在 指定 的 程序 集中 ， 
只 有 该 类 将 被 链接 进来 。 如 果 插 入 ViewImports.cshtml 文件 中 ， 那 么 @addTagHelper 
指令 将 被 目 动 添加 到 任何 被 处 理 的 Razor 视图 中 ，。 


2. 将 标记 帮助 程序 附加 到 HTML 元 素 上 


初 看 上 去 , 可 把 标记 帮助 程序 看 成 Razor 解析 器 处 理 的 一 个 目 定义 HTML 特性 
或 目 定 义 HIML 元 素 。 下 面 显示 了 如 何 使 用 一 个 示例 标记 玫 助 程序 。 


<img src="~/images/app-logo.png" asp-append-version="true"™" /> 
下 面 给 出 了 男 外 一 个 例子 。 


<environment names="Development™"> 
<script src="~/content/scripts/yourapp.dev.js" /> 
</environment> 
<environment names="Staging, Productijon"> 
<sScript src="~/content/scripts/yourapp.min.js" asp-append-version="true" /> 
</environment> 


注册 为 标记 帮助 程序 的 程序 集 告诉 Razor 解析 器 ， 在 标记 表达 式 中 发 现 的 哪些 
特性 和 元 又 应 该 在 服务 嚣 问 处 理 ， 以 便 生 成 实际 的 标记 供 浏览 器 使 用 。Visual Studio 
会 用 特殊 的 闫 色 强 调 被 识别 为 标记 帮助 程序 的 特性 和 元 系 。 

特别 是 , asp-append-version 标记 帮助 程序 会 修改 绑 定 的 元 素 , 在 引用 文件 的 URL 
中 添加 一 个 时 间 玲 ,使 浏览 磺 不 缓存 该 文件 。 下 面 给 出 了 为 上 和 面 的 IMG 元 系 实 际 生 
成 的 标记 。 


<img src="/images/app-logo.png?v=yqomE4A3 PDemMMVt—umA™" /> 


在 URL 后 面 会 目 动 奶 加 一 个 版 本 得 询 字符 串 参 数 ， 这 个 参数 计算 为 文件 内 容 
的 哈 希 。 这 和 意味 痢 每 当 文件 变化 时 ， 会 生成 一 个 新 的 版 本 字符 串 ， 使 浏览 郁 的 组 
存 失 效 。 在 开发 过 程 中 ， 每 当 一 个 外 部 资源 (如 图 片 、 样 式 表 或 脚本 文件 ) 变 化 时 ， 
部 知 要 清理 浏览 如 的 缓存 ， 上 和 耐 这 种 简单 的 迁 回 方法 解决 了 这 个 长 期 存在 的 开发 
问题 。 


注意 : 
如 果 引 用 的 文件 不 存在 ， 则 不 会 生成 任何 版 本 字符 串 。 与 之 相对 ，environment 
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标记 才 助 程序 都 被 配置 为 绑 定 到 特定 的 HTMIL 元 素 .可 以 把 多 标记 帮助 程序 附加 给 
相同 的 HIML 元 素 。 
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6.2.2 内置 的 标记 帮助 程序 


ASPNET Core 目 融 了 许多 预定 义 的 标记 帮助 程序 。 所 有 预定 义 的 标记 帮助 程序 
都 在 一 个 相同 的 程序 集中 定义 ， 而 我 们 很 可 能 会 在 ViewImports.cshtml 文件 中 引用 
这 个 程序 集 ， 这 就 保证 了 所 有 的 Razor 视图 都 能 够 使 用 内 置 的 标记 帮助 程序 。 


QaddTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers 


内 置 的 标记 帮助 程序 敌 兰 了 多 种 功能 。 例 如 ， 一 些 标记 帮助 程序 会 影 啊 Razor 
模板 中 也 可 使 用 的 HIML 元 素 : FORM、INPUT、TEXTAREA、LABEL 和 SELECT。 
还 有 许多 玫 助 程序 可 用 于 验证 要 显示 给 用 户 的 消息 。 系 统 提 供 的 所 有 标记 帮助 程序 
都 人 有 asp-* 名 称 前 级 。 以 下 网 址 提供 了 完整 参考 : http://docs.microsoft.com/en-us/ 


aspnet/core/apy/microsotft.aspnetcore.mvc.taghelpers.。 
1. 标记 帮助 程序 的 常规 结构 


接 下 来 的 小 节 将 介绍 一 些 内 置 的 标记 帮助 程序 。 为 了 帮助 理解 ， 我 们 首先 来 看 
看 标记 帮助 程序 的 内 部 组 成 ， 以 及 它们 的 核心 特征 信息 。 

标记 帮助 程序 类 由 其 能 够 引用 的 一 个 或 多 个 HTML 元 素来 标识 。 标记 帮助 程序 
类 主要 由 实际 行为 实现 中 使 用 的 公有 属性 和 私有 方法 构成 。 每 个 公有 属性 可 能 用 其 
关联 的 标记 帮助 程序 特性 的 名 称 来 修饰 。 例如, 下 面 给 出 了 定位 标记 帮助 程序 的 C# 
类 的 声明 。 


[HtmlTargetElement ("a", Attributes = "asp-action™)| 
[HtmlTargetElement ("a", Attributes = "asp-controller™")| 
[HtmlTargetElement ("a", Attributes = "asp-area")| 
[HtmlTargetElement("a", Attributes = "asp-fragment™)| 
[HtmlTargetElement ("a", Attrilbutes = "asp-host™")]| 
[HtmlTargetElement ("a", Attributes = "asp-protocol™)| 
[HtmlTargetElement ("a", Attributes = "asp-route"™)| 
[HtmlTargetElement ("a", Attributes = "asp-all-route-data"™)| 
[HtmlTargetElement ("a", Attributes = "asp-route—*™)| 


public class AnchorTagHelper : TagHelper, lITagHelper 
{ 


} 

看 起 来 ， 该 该 标记 帮助 程序 只 能 与 带 有 列表 中 的 任何 特性 的 A 元 素 关 联 在 一 起 。 
换 句 话说, 如 果 Razor 只 包含 普通 的 <a hre 伍 "...">...</a> 元 素 , 不 带 上 面 的 任何 asp-* 
特性 ， 那 么 将 直接 生成 该 标记 ， 不作 进 一 步 处 理 。 图 6-1 显示 ，Visual Studio 能 够 检 
测 出 某 些 已 注册 的 标记 帮助 程序 实际 文 持 哪些 asp-* 特 性 。 

正如 图 中 所 见 ，Visual Studio 检测 到 asp-hello 不 是 任何 已 注册 标记 帮助 程序 的 
A 元 素 的 有 效 特 性 。 
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Be Server.Models .HomeViewModel 


-<a asp-controller="Home”" 
asp-action="Room" 
asp-hello="hello">Sample linkk/a> 


<hr/> 


图 6-1 有 效 和 无 效 的 标记 帮助 程序 特性 
2. 定位 标记 帮助 程序 


定位 标记 帮助 程序 用 于 A 元 素 , 允许 极为 灵活 地 指定 该 元 素 指 问 的 URL。 事实 
上 ， 在 指定 目标 URL 时 ， 可 以 将 其 分 解 为 区 域 -控制 匿 -操作 组 件 ， 可 以 投 路 由 名 称 
站 定 ， 其 至 可 以 指定 URL 段 ， 如 主机 、 片 段 和 协议 。 图 6-1 显示 了 如 何 使 用 定位 标 
记 帮 助 程序 。 


; 土 忌 
如 果 同 时 指定 了 href 特性 和 路 由 特性 ， 那 么 帮助 程序 类 将 抛 出 一 个 异 第 。 
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3. 表单 标记 帮助 程序 

表单 标记 帮助 程序 文 持 使 用 特性 ， 通 过 控制 磺 和 操作 名 称 或 者 通过 路 由 名 称 来 
设 普 操作 URL。 

<form asp-controller="room” asp-action="book"> 


</form> 


下 和 耐 的 Razor 代码 将 method 特性 设 为 POST， 将 action 特性 设 为 指定 的 控制 器 


和 操作 组 合 得 到 的 URL。 男 外 ， 表 单 标 记 帮 助 程序 做 了 一 些 有 趣 而 又 复杂 的 工作 : 


它 注入 了 一 个 隐藏 字段 ， 该 字段 市 有 请 求 验证 标记 ， 而 这 个 标记 是 定制 的 ， 用 于 防 
止 跨 站 请 求 伪 造 (Cross-Site Request Foreery，XSRF) 攻 击 。 


<form method="POST" action="/room/book" 
<input name=" RequestVerificationToken™" type="hidden" value="..." /> 


人 

它 还 添加 了 一 个 cookie， 并 在 cookie 中 保存 该 字段 中 存储 的 值 ， 但 对 这 个 值 进 
行 了 加 密 。 只 要 也 使 用 服务 器 疹 特 性 修饰 接收 方 控制 器 (就 像 下 面 这 样 )， 这 种 方法 
就 能 够 牢固 地 防御 XSRF 攻击 。 


[AutoValidateFforgeryTokenl| 
Public class RoomController : Controller 
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AutoValidateForgeryToken 特性 将 读 取 请 求 验 证 cookie， 进 行 解密 ， 然 后 将 其 值 
与 请 求 验证 隐 叫 字段 的 value 特性 的 内 容 进行 比较 。 如 果 不 匹 配 ， 吏 抛 出 卉 第 。 如 
果 没 有 AutoValidateForgeryToken 特性 ， 丈 无 法 进行 双重 检 栓 。 通 单 ， 会 在 控制 器 级 
别 使 用 该 特性 ， 或 者 更 好 的 方法 是 ， 将 其 用 作 全 局 哺 选 器 。 此 时 ， 如 果 只 想 针 对 麻 
些 方法 禁用 该 特性 ， 那 么 可 以 使 用 IenoreValidateForgeryToken 特性 。 


注意 : 
在 ASPNET Core 中 ， 还 有 一 个 类 似 的 特性 ， 名 为 ValidateForgeryToken。 其 与 
AutoValidateForgeryToken 的 区 别 是 ， 后 者 只 检查 POST 请 求 。 


4. 输入 标记 帮助 程序 


输入 标记 帮助 程序 将 INPUT 元 素 绑 定 到 一 个 模型 表达 式 。 绑 定 是 通过 asp-for 
特性 实现 的 ， 注意，asp-for 特性 也 用 于 LABEL 元 素 。 


<div class="form-group"> 
<label class="col-md-4 control-label™" asp-for="Title"></label> 
<div class="col-—md 4"> 
<input class="form-—control input--lg” asp-foro—"Title" > 
</div> 
</div> 


INPUT 元 素 的 asp-for 特性 根据 表达 式 生成 name、id、type 和 value 特性 。 在 示 
例 中 ， 值 Title 引用 绑 定 的 视 狗 模型 上 的 对 应 属性 。 对 于 LABEL 元 素 ，asp-for 特性 
设置 for 特性 ， 并 且 作 为 可 选项 ， 还 可 以 设置 标签 的 内 容 。 结 果 如 下 所 示 。 

<div class="form-group"> 

<label class="col-—md—4 control—label™ for="Title">Title</label> 
<diyv class="col-—md—4"> 
<input class="form-—-control input—lg"™ 
type="text™” id="Title” name="Title™ value="..."» 
</div> 

</div> 

INPUT 字段 的 value 属性 将 获得 表达 式 生 成 的 值 。 注 意 ， 也 可 以 使 用 复杂 的 表 
达 式 ， 如 CustomerName。 

为 了 确定 最 合适 的 字段 类 型 ，asp-for 特性 还 会 租 看 视图 模型 类 上 可 能 定义 的 数 
据 注 释 。 如 末 已 经 在 标记 中 指定 了 受到 影 啊 的 特性 ， 则 这 些 特 性 不 会 被 禾 凋 。 帮 外 ， 
根据 数据 注释 , asp-for 特性 可 以 生成 HIMLS 验证 特性 , 读 取 错误 消息 和 验证 规则 。 
验证 标记 帮助 程序 会 使 用 生成 的 这 些 data-* 验 证 特性 ， 如 果 配 置 了 jQuery 验证 的 客 
户 站 验证 ， 那 么 也 会 使 用 这 些 data-* 验 证 特性 。 

最 后 ， 需 要 注意 ， 如 末 视 图 模型 的 结构 上 及 生 了 变化 ， 而 标记 帮助 程序 表达 式 没 
有 更 新 ， 那 么 将 生成 编 详 时 铬 误 。 
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5. 验证 标记 帮助 程序 


验证 标记 帮助 程序 分 为 两 种 类 型 : 验证 单独 的 属性 以 及 验证 总 结 。 特 别 是 ， 验 
证 消息 帮助 程序 会 使 用 SPAN 元 素 上 的 asp-validation-for 特性 的 值 。 

<span asp-validation-for="Email"></span> 

该 SPAN 元 素 设置 了 对 应 的 HTMLS5 验证 消息 ， 这 条 消息 是 Email INPUT 字段 
痊 出 的 。 如 果 需 要 泻 染 任何 铅 误 消 息 ， 则 把 它们 演 染 为 SPAN 元 素 的 主体 内 容 。 

<div asp-validation-summary="All"></span> 

与 之 不 同 ， 验 证 电 结 帮助 程序 则 使 用 DIV 元 素 的 asp-validation-summary 特性 。 
其 输出 是 一 个 UL 元 素 ， 列 出 了 表单 中 的 全 部 验证 销 误 。 该 特性 的 值 决 定 了 列举 哪 
些 错误 。 可 用 的 值 包括 All 和 Modelonly，All 表示 列举 所 有 的 错误 ，ModelOnly 表 
示 只 列举 模型 铅 误 。 

6. 选择 列表 标记 帮助 程序 

SELECT 元 又 的 标记 带 助 程序 特别 值得 注意 ,因为 它 为 Web 开发 人 员 解 决 了 一 
个 由 来 已 久 的 问题 : 找到 一 种 最 侧 洁 、 最 有 效 的 方式 将 枚 举 拓 型 绑 定 到 下 拉 列 表 。 


<Select 1q= "Foom ”name 一 ”Toom” class="form—control" 


asp-for="Q@Model .CurrentRoomType" 
asp-items="Q@Html .GetEnumSelectList (typeof (RoomCategories)) "> 
</select> 


在 SELECT 元 素 中 ，asp-for 指 问 要 求 值 的 表达 式 ， 以 便 找 到 列表 中 的 选 定 项 。 
asp-items 则 提供 了 项 目 列表 。 新 增 的 Html.GetEnumSelectList 扩展 方法 接受 一 个 榴 
举 类 型 参数 ， 将 其 序列 化 为 一 个 SelectListItem 对 象 的 列表 。 


public enum RoomCategories 


{ 
[Displayl(Name = "Not specified")l] 
None = 0,， 
Single = 1, 
Double = 2 
} 


好 处 是 ， 如 果 使 用 了 Display 特性 修饰 枚 举 中 的 任何 元 素 ， 则 泻 染 的 名 称 将 是 
指定 的 文本 ， 而 不 是 字面 值 。 有 意思 的 是 ， 生 成 的 选项 的 值 是 枚 举 项 的 数字 值 ， 而 
不 是 名 称 。 
6.2.3 ”编写 自 定义 标记 帮助 程序 

标记 帮助 程序 可 使 Razor 模板 保持 简洁 ， 并 具备 良好 的 可 读 性 。 但 是 ， 我 只 会 
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使 用 标记 帮助 程序 来 目 动 完成 元 长 的 、 备 复 性 强 的 标记 代码 块 的 编写 ， 而 不 会 使 用 
它们 创建 视图 特定 的 语言 等 。 事实 上 ， 越 这 么 做 ， 器 越 远 离 普 通 的 HTML。 


1. 创建 电子 邮件 标记 帮助 程序 的 动机 


假设 一 些 视图 将 电子 邮件 的 地 址 显示 为 纯 文本 。 如 果 使 这 些 字 符 串 可 被 点 击 ， 
并 且 点 击 后 弹出 Outlook 新 邮件 窗口 ， 不 是 很 好 吗 ? 使 用 HIML 很 容易 实现 这 种 功 
能 ， 只 需要 使 文本 变 为 定位 文本 ， 并 使 其 指 问 一 个 mailto 协议 字符 串 。 

<a href="mailto:you@yourserver.com">you@yourserver.com</a> 

在 Razor 中 ， 人 代码 是 这 样 的 : 

<a href="mailto:@Model.Email">Q@Model .Email</a> 


这 样 的 代码 并 不 是 特别 难以 阅读 和 维护 ， 但 是 ， 如 果 还 想 指定 电子 邮件 的 默认 
主题 、 内 容 、 抄 送 地 址 等 ， 该 怎么 办 ? 此 时 ， 要 编写 的 代码 就 变 得 复杂 多 了 。 必 须 
检查 主题 是 否 非 室 ， 并 将 其 添加 到 mailto 协议 字符 串 中 ; 对 于 其 他 任何 要 处 理 的 特 
性 ， 需 要 执行 相同 的 操作 。 很 可 能 最 终 会 使 用 一 个 本 地 的 StringBuilder 变量 来 合并 
得 到 最 终 的 mailto URL。 这 样 的 代码 会 污染 视图 ， 而 没有 为 视图 增加 蕊 义 ， 因 为 它 
只 是 执行 了 样板 转换 ， 将 数据 转换 成 了 标记 。 


2. 规划 标记 帮助 程序 


标记 帮助 程序 能 够 帮助 阅读 转换 的 细节 ， 并 在 视图 中 隐藏 转换 的 细节 。 现 在 就 
可 以 使 用 下 和 面 的 标记 。 
<email to="Q@Model .Email .To™ 
subject="Q@Model .Email.subject"™"> 


QModel .Email.Body 
</email> 


必须 在 视图 中 注册 标记 帮助 程序 类 ， 可 以 注册 到 视图 本 里 中 ， 也 可 以 注册 到 
_ViewImports.cshtml 文件 中 ， 以 便 对 所 有 视图 可 用 。 注 册 方 法 如 下 : 

QaddTagHelper *, Your.Assembly 

新 的 标记 帮助 程序 有 一 个 目 定 义 元 素 ,通过 为 其 添加 额外 的 属性 (如 CC)， 可 使 
其 更 加 复杂 。 


3. 实现 标记 帮助 程序 


典型 的 标记 帮助 程序 类 继承 了 TagHelper， 并 重 与 ProcessAsync 方法 。 访 方法 
负责 为 帮助 程序 控制 的 任何 标记 生成 输出 。 
如 前 所 述 , 要 将 Razor 元 系 绑 定 到 帮助 程序 , 需要 使 用 HtmlTargetElement 特性 。 
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该 特性 包含 了 帮助 程序 将 绑 定 到 的 元 又 的 名 称 。 


[HtmlTargetElement ("email™")| 
public class MyEmailTagHelper : TagHelper 
{ 
Public override asvync Task ProcessAsvyncl 
TagHelperContext context, TagHelperOutput output) 
{ 
// Evaluate the Razor Content of the email's element body 
var body = (await output.GetChildContentAsync(}) .GetContent () 7 


// Replace <email> with <a> 


output.TagName = "a"™} 
// Prepare mailto URL 
var to = context .AllAttributes["to"| .Value.ToString(}; 
var subject = context.AllAttributes|["subject" |] .Value.Tostring(}); 
Var malilto = "mailto:™ + to; 
if (!string.IsNullOrWhiteSpace (subject)) 
mailto = string.Format (" {0}&subject={l1}&body={2}", mailto, 
subject, body); 


// Prepare output 

output .Attributes.Clear (}); 

output .Attributes.SetAttribute("href", mailto); 
output.Content.cClear () ; 
output.Content.AppendFormat ("Email {10} ”七 D) 7; 


} 
图 6-2 显示 了 一 个 使 用 该 帮助 程序 的 Razor 视图 示例 。 生 成 的 标记 如 下 所 示 : 


<a href="mailto:dino.espositol@jetbrains.com&tsubject=Talking about ASP.NET 
Coreg&gtbody~=Hellol!™> 

Email dino.espositol@jetbrains .com 
< /a> 


=<email to="B@email" subject="@subject"> 
Hello! 


</emaily| 


图 6-2 在 Visual Studio 2017 中 显示 的 标记 帮助 程序 示例 
图 6-3 显示 了 相应 的 页 面 。 
如 果 目 标 元 素 的 名 称 不 足以 限制 受 标 记 帮 助 程序 控制 的 元 素 , 则 可 以 添加 特性 。 
[HtmlTargetElement ("email™", Attributes="to, subject")] 


像 上 面 这 样 修饰 的 标记 帮助 程序 只 会 应 用 到 同时 指定 了 两 个 特性 且 特 性 不 为 空 
的 EMAIL 元 素 。 如 果 没有 标记 帮助 程序 能 够 与 自 定义 标记 匹配 ， 则 原封 不 动 地 发 
出 标记 ， 每 个 浏览 器 将 以 某 种 方式 处 理 这 些 标记 。 
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Emall dino.esposito(@jetbrains.com 


名 - 二 Talking... 到 = 国 


Message LN ens Format Text Review VY Tell me 


外 ICalibri 
Paste yy.A. \ Names ue lags | Office 


Clipboard 5 Basic Text 3 Add-ins 


Add-ins 


| From™ LIBERO 


subject Talking about ASP.NET Core 


Hellol 


图 6-3 示例 页 和 面 
4. 标记 帮助 程序 与 HTML 帮助 程序 的 对 比 


在 ASPNET Core 中 ,有 两 个 相似 的 工具 可 以 提高 Razor 视图 中 标记 语言 的 抽象 
级 别 : HTML 帮助 程序 (经 典 ASPNET MVC 也 支持 ) 和 标记 帮助 程序 。 这 两 个 工具 
可 完成 相同 的 工作 ， 并 且 都 为 相对 复习 的 重复 性 的 Razor 任务 提供 了 易于 使 用 的 语 
法 。 但 是 ，HTML 帮助 程序 是 通过 编程 调用 的 一 个 扩展 方法 。 


Htm1l .MyDropDownList(...) 


e HTML 帮助 程序 包含 标记 或 者 通过 编程 生成 标记 。 但 是 , 这 种 标记 是 对 外 隐 
饿 的 。 假设 现在 需要 编辑 内 部 标记 的 一 个 人 简单 特性 , 例如 同 示 个 元 系 添 加 一 
个 CSS 类 。 只 要 是 一 般 性 的 修改 ， 并 且 会 应 用 到 帮助 程序 的 所 有 实例 ， 那 
么 这 个 任务 并 不 难 。 如 果 想 为 每 个 实例 指定 不 同 的 CSS 特性 ， 那 么 必须 把 
该 CSS 特性 作为 帮助 程序 的 一 个 输入 参数 。 做 这 种 修改 对 于 内 部 标记 和 外 
图 的 API 都 会 产生 巨大 影 啊 。 

e 相反 , 标记 帮助 程序 只 是 视图 中 围绕 标记 的 代码。 这 种 代码 根 据 每 种 情况 说 
明 如 何 操纵 指定 的 模板 。 


6.3 Razor 视图 组 件 
视图 组 件 是 ASPNET MVC 世界 中 的 一 个 相对 较 新 的 成 员 。 从 技术 上 讲 ， 它 们 


141 


第 中 部 分 ASPNET MVC 应 用 程序 模型 


是 自 包含 的 组 件 ， 既 包含 逻辑 ， 又 包含 视图 。 在 这 个 方面 ， 它 们 是 经 典 ASPNET 中 
的 子 操作 的 改进 版 本 ， 也 是 其 蔡 代 品 。 


6.3.1 编写 视图 组 件 


在 视图 中 ， 通 过 C# 代 人 码 块 来 引用 视图 组 件 ， 并 同 它 们 传递 任何 必要 的 输入 数 
据 。 在 内 部 ， 视 图 组 件 将 运行 目 己 的 逻辑 ， 处 理 传 入 的 数据 ， 并 返回 视图 供 渔 染 。 

与 标记 帮助 程序 不 同 ，ASP.NET Core 没有 任何 预定 义 的 视图 组 件 。 因 此 ,视图 
组 件 是 在 每 个 应 用 程序 中 创建 的 。 


1. ViewComponent 的 实现 


视图 组 件 是 继承 了 ViewComponent 的 类 ， 并 公开 一 个 InvokeAsync 方法 ， 议 方 
法 的 签名 与 可 能 在 Razor 视图 中 传 入 的 输入 数据 匹配 。 下 面 给 出 了 视图 组 件 的 核心 
代码 的 一 种 合理 的 布局 。 

public async Task<IViewComponentResult> InvokeAsync( /* input data */ ) 

Var data = await RetrieveSomeDataAsync(/* input data */); 


return Viewl(data),; 


} 
在 视图 组 件 内 ， 可 能 有 数据 库 或 服务 引用 ， 并 可 能 要 求 系统 注入 依赖 。 这 是 完 
全 不 同 的 业务 逻辑 ， 它 负责 从 数据 源 获取 数据 ， 并 把 数据 打包 成 一 段 HIML。 


2. 将 组 件 连 接 到 Razor 视图 


可 以 把 视图 组 件 类 放 到 项 目 中 的 任意 位 置 ， 但 是 视图 组 件 使 用 的 所 有 视图 必须 
位 于 特定 的 位 置 。 特 别 是 ， 必 须 有 一 个 Components 文件 夹 ， 每 个 视图 组 件 在 该 文 
件 夹 下 都 有 一 个 子 文 件 夹 。 通 第 把 Components 文件 夹 放 到 Views/Shared 文件 夹 下 ， 
以 确保 组 件 可 完全 重用 。 如 果 情 况 决 定 了 需要 把 多 个 视图 组 件 仅 用 于 一 个 控制 占 ， 
那么 在 Views 中 的 控制 器 文件 严 下 有 一 个 Components 文件 夹 也 是 可 以 的 。 

视图 组 件 文件 夹 的 名 称 就 是 视图 组 件 类 的 名 称 。 注 意 ， 如 果 类 名 带 有 
ViewComponent 后 级 ， 则 将 移 除 该 后 级 。 此 文件 来 包含 使 用 到 的 所 有 Razor 视图 。 
从 InvokeAsync 方法 返回 时 ， 如 果 没 有 指定 视图 名 称 ， 则 使 用 default.cshtml 文件 。 
该 视图 是 一 个 常规 的 Razor 视图 ， 包 含 常用 的 指令 。 


3. 调用 视图 组 件 


要 在 视图 内 调用 视 岁 组 件 ， 需 要 使 用 下 和 面 的 代码 。 注 总， 下面 的 Component. 
InvokeAsync 方法 可 接受 任意 参数 ， 这 些 参 数 将 被 传递 给 引用 组 件 的 内 部 实现 的 
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InvokeAsync 方法 。Component.InvokeAsync 方法 是 要 生成 的 标记 的 占 位 符 。 
Qawait Component.InvokeAsync ("LatestBookings", new { maxLength = 4 }) 
注 章 ， 探 制 费 也 可 以 调用 视图 组 件 。 此 时 ， 要 使 用 的 代码 如 下 所 示 。 


public IActionResult LatestBookings (int maxNumber) 
{ 
return VIewCompPponent ("LatestBookings", maxNumber); 


} 

这 种 方法 类 似 于 返回 一 个 分 部 视图 。 对 于 这 两 种 情况 ， 调 用 方 都 将 收 到 一 个 
HTML 片段 。 分 部 视图 与 视图 组 件 的 区 别 在 于 它们 的 内 部 实现 。 分 部 视图 是 一 个 普 
通 的 Razor 模板 ， 在 模板 中 接受 并 包含 数据 。 视 图 组 件 接受 输入 参数 ， 获 取 其 数据 ， 
然后 在 模板 中 包含 数据 。 


6.3.2 Composition Ul 模式 


视图 组 件 可 使 视图 变 得 组 件 化 ， 使 其 成 为 不 同 的 日 制 小 组 件 的 组 合 结果 。 这 种 
Composition UI 模式 虽然 昕 起 来 很 融 深 但 是 实际 上 是 一 个 非常 直观 的 概念 。 


1. 聚合 数据 和 UI 模板 


理想 情况 下 ， 应 用 程序 中 的 一 些 视 图 应 该 是 不 同 得 询 得 到 的 数据 聚合 在 一 起 的 
结果 。 在 这 种 情况 中 ， 俘 询 不 一 定 是 数据 库 伍 询 ， 它 只 是 一 种 按照 视图 需要 的 形式 
返回 数据 的 操作 。 可 以 定义 一 个 规范 的 视图 模型 对 象 ， 并 让 应 用 程序 控制 费 使 用 其 
从 几 种 操作 (可 能 是 并 行 操作 ) 得 到 的 数据 来 赴 元 该 对 象 。 考 虑 下 向 这 个 用 于 仪表 板 
钢 图 的 视图 模型 。 


public Class DashboardViewModel 


{ 
public IList<MonthlyRevenue> ByMonth { get; sets; | 
public IList<EmPloyeeofTheMonth> TopPerformers !{ get set; |】 
Public int PercentageOofPeopleInTheOffice 1{ get; set; 上 

} 


可 以 看 到 ， 定 义 了 一 个 规 儿 的 视图 模型 对 象 ， 将 用 户 想 要 在 同一 个 视图 中 看 到 
的 3 种 完全 不 同 的 信息 聚合 到 了 一 起 : 月 度 收 入 、 最 佳 表现 者 列表 ， 以 及 到 当前 为 
止 进 入 办 公 室 的 人 数 百分比 。 

一 般 来 说 ， 这 些 信息 可 位 于 同一 个 数据 库 中 ， 也 可 以 位 于 多 个 数据 库 中 ， 甚 全 
多 个 服务 右上。 因此 ， 应 用 程序 服务 通 间 将 触 友 3 个 调用 来 获取 数据 。 

public DashboardViewModel Populate() 


{ 


Var model = new DashboardViewModel () ; 
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// Trigger the monthly revenue query 
model .ByMonth = RetrieveMonthlyRevenues (DateTime.Now.Year); 


// Trigger the top performers query 
model .TopPerformers = RetrieveTopPerformersRevenues (DateTime .Now.Year, 
DateTime.Now.Month):; 


// Trigger the occupancy query 
model .PercentageOfPeopleInTheOffijce = RetrieveOccupancy (DateTime .Now); 


return model:; 


} 


在 这 种 方法 中 ， 集 中 获取 数据 。 该 视 独 很 可 能 由 3 个 不 同 的 分 部 视图 组 成 ， 每 
个 分 部 视图 获取 一 段 数 据 。 
<div>Q@Htm]l .Partial ("pv MonthlyRevenues", Model.ByMonth)</div> 


<div>Q@Htm]l .Partial ("pv TopPerformers", Model.TopPerformers)</div> 
<div>Q@Html .Partial ("pv Occupancy", Model .PercentageofPeopleInTheOoffice)</div> 


男 外 一 种 方法 是 将 这 个 视图 分 解 为 3 个 更 小 的 独立 部 分 ， 每 个 部 分 专门 用 于 一 
个 查询 任务 。 视 图 组 件 就 是 一 个 分 部 视图 加 上 一 些 专门 的 查询 逻辑 。 因 此 ， 相 同 的 
视图 也 可 以 用 下 和 而 的 方式 表达 。 

<div>lawait Component.InvokeAsync ("MonthlyRevenues", DateTime.Now.Year)</div> 


<div>Q@await Component .InVokeAsync ("TopPerformers", DateTime.Now) </div> 
<div>Qawait Component.InvokeAsync ("Occupancy", DateTime .Now)</div> 


负责 泻 染 仪表 板 视图 的 控制 磊 并 不 需要 使 用 应 用 程序 服务 ， 而 是 可 以 只 负责 海 
染 视 图 。 泻 染 视 图 的 操作 将 触 友 组 件 。 


2. 视图 组 件 与 子 操作 的 对 比 


乍 看 上 去 ， 视 图 组 件 与 经 典 ASPNET MVC 中 的 分 部 视图 和 子 操作 很 相似 。 
ASPNET Core 有 分 部 视图 ， 但 是 没有 子 操 作 。 相 比 子 操作 ， 视 图 组 件 更 快 ， 因 为 它 
不 像 子 操作 那样 需要 经 过 控制 器 管道 。 这 意味 着 不 会 进行 模型 绑 定 ， 也 没有 操作 和 

那么 ， 视 图 组 件 与 分 部 视图 相 比 ， 有 什么 区 别 呢 ? 

分 部 视图 束 是 模板 ， 可 接受 和 洽 染 数据 ， 它 们 没有 后 端 逻 辑 。 分 部 视图 通常 不 
包含 代码 , 或 者 只 包含 一 些 泻 染 逻 辑 。 视 图 组 件 通 常会 查询 某 个 数据 库 来 获取 数据 。 


3. 视图 组 件 的 影响 

将 视图 分 割 为 独立 的 组 件 主 要 是 方便 组 织 工作 的 一 种 方法 ;， 它 还 可 以 让 不 同 的 
开 友 人 员 有 负责 不 同 的 部 分 ， 从 而 使 创建 视图 的 工作 能 够 并 行进 行 。 但 是 ， 视 网 组 件 
并 不 一 定 能 够 加 快 应 用 程序 的 开 及 。 

因为 每 个 视图 组 件 都 是 独立 渔 染 (并 被 坦 序 数据 的 )， 所 以 数据 库 远 辑 可 能 不 会 
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征 最 优 的 。 除 非 数 据 保存 在 独立 的 且 不 相关 的 数据 源 中 ， 否 则 多 个 独立 的 查询 可 能 
需要 多 个 连接 和 多 条 命令 。 

一 般 来 说 , 要 确保 将 视图 分 割 为 不 同 的 组 件 时 , 整体 的 合 询 逻辑 不 会 受到 影响 。 
下 面 给 出 一 个 例子 。 假 议 东 个 网 站 的 主页 必须 泻 染 两 个 框 ， 一 个 框 中 显示 3 条 最 新 
的 新 闻 头 条 ， 为 一 个 框 中 显示 最 新 的 10 条 新 闻 ， 并 市 有 图 请 、 标 题 和 所要。 如 末 便 
用 不 同 的 视 岁 组 件 ， 则 需要 对 同一 个 数据 库 表 执行 两 条 不 同 的 查询 。 相 反 ， 集 中 的 
数据 检索 过 程 很 可 能 只 需要 一 条 答 询 。 


6.4 小结 


ASPNET Core 中 的 Razor 语言 与 经 典 ASPNET MVC 中 的 基本 上 是 相同 的 。 
ASPNET Core 中 新 增 了 几 条 指令 ， 用 于 新 的 框架 功能 :标记 帮助 程序 和 依赖 注入 。 
另外 ， 还 新 增 了 视图 组 件 ， 这 是 一 种 新 的 组 件 类 型 ， 用 于 可 重用 的 应 用 程序 内 的 
HTML 小 组 件 。 除 了 这 些 变 化 之 外 ，Razor 语言 在 ASPNET Core 中 的 工作 方式 与 在 
经 典 ASPNET MVC 中 是 类 似 的 。 

本 草 结 束 后 ， 我 们 束 完 成 了 对 ASPNET Core 应 用 程序 模型 的 介绍 。 从 第 7 章 
开始 ， 将 介绍 一 些 跨 领域 关注 点 ， 并 讨论 依赖 注入 、 腊 笛 处 理 和 配置 等 主题 。 
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现在 读者 已 经 熟悉 了 ASPNET Core 项 目 以 及 MVC 应 用 程序 模型 ， 我 
们 将 开始 介绍 在 真实 环境 中 构建 生产 解决 方案 时 ， 可 能 过 到 的 一 些 问题 ， 包 
括 配 置 、 身 份 验证 和 数据 访问 。 

第 7 章 将 介绍 ASPNET Core 的 原生 依赖 注入 (DD 基础 结构 的 关键 作用 ， 
并 解决 一 些 普遍 存在 的 挑战 ， 如 管理 全 局 配置 数据 、 处 理 错 误 和 异常 ， 以 及 
设计 控制 右 。 

第 8 章 将 介绍 如 何在 ASPNET Core 中 实现 用 户 身 份 验证 ， 并 使 用 其 新 
增 的 基于 策略 的 API 来 进行 用 户 授 权 。 虽 然 ASPNET Core 依赖 我 们 熟悉 的 
身份 验证 概念 ， 但 是 有 经 验 的 ASPNET 开发 人 员 会 发 现 ，ASPNET Core 在 
这 些 概 念 的 实现 上 有 了 很 大 的 区 别 。 

第 9 章 将 使 用 现代 的 设计 优先 的 方法 来 处 理 数据 访问 。 该 章 以 Eric Evans 
在 领域 驱动 设计 (Domain-driven Design，DDD) 上 做 出 的 大 有 影 啊 力 的 创新 为 
基础 ， 硕 助 恋 者 掌握 一 种 现代 的 、 提 供 持久 化 的 应 用 程序 后 痛 模 式 。 之 后 ， 
将 在 ASPNET Core 中 使 用 这 种 模式 读 写 数据 。 完 成 该 章 后 ， 谈 者 将 能 够 处 
理 各 种 数据 访问 问题 ， 不 管 涉 及 的 是 NoSQL 存储 、 云 还 是 其 他 技术 。 


要 双方 都 不 小 心 才 能 造成 一 次 车 祸 。 
弗 表 西 斯 "斯 科 特 。 菲 欧 杰 拉 德 , 《了 不 起 的 新 次 比 》 


本 章 介 绍 所 有 Web 应 用 程序 的 路 领域 的 一 些 关 注 点 ， 例 如 全 局 配置 数据 、 处 理 
错误 和 异常 的 模式 、 控 制 器 类 的 设计 ， 以 及 一 些 现代 功能 (如 在 代码 层 中 传递 数据 的 
依赖 注入 )。 在 设计 ASP.NET Core 应 用 程序 的 核心 组 件 时 ， 原 生 的 依赖 注入 框架 扮 
演 看 根本 性 的 作用 。 

话 不 多 说 ,我 们 来 深入 介绍 ASPNET Core 框架 的 原生 DI 基础 结构 的 内 部 机 制 |。 


7.1 依赖 注入 基础 结构 
DI 是 一 种 开发 模式 ， 被 广泛 用 于 使 服务 可 被 应 用 程序 任何 位 置 的 代码 使 用 。 每 
当 某 个 代 但 组 件 ( 如 一 个 类 ) 需 要 引用 某 些 外 部 代码 (如 一 个 服务 ) 时 ， 都 有 两 种 选择 。 
e 首先 ， 直 接 在 调用 代码 中 创建 服务 组 件 的 一 个 新 实例 。 
e 有 其次， 期望 收 到 该 服务 的 一 个 有 效 实 例 ， 这 个 实例 是 其 他 人 创建 的 。 下 面 我 
们 用 一 个 示例 进行 演示 。 
7.1.1 进行 重 构 以 隔离 依赖 


假设 有 一 个 类 ， 该 类 封装 了 一 项 外 部 功能 ， 如 记录 器 。 在 下 面 的 代码 中 ， 该 类 
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与 此 功能 的 一 个 具体 实现 崇 密 精 合 在 一 起 。 


public class BusinessTask 


{ 
Public void Pertorm () 
// Get hold of the dependency 
Var logger = new Logger(); 
// Perform task 
// Use the dependency 
logger.Log ("Done™); 
} 
} 


如 果 将 该 类 移动 到 其 他 位 苟 ， 则 必须 也 移动 引用 的 组 件 及 其 所 有 依赖 ， 奋 则 访 
关 将 无 法 继续 工作 。 例 如 ， 如 条 记录 需 使 用 了 一 个 数据 库 ， 那 么 在 使 用 此 业务 闫 的 
任何 地 方 ， 数 据 库 的 连接 都 必须 是 可 用 的 。 


1. 将 应 用 程序 代码 与 依赖 解 耦 


面 问 对 象 议 计 的 一 项 吝 老 而 明知 的 原则 指出 ， 应 该 针对 接口 编程 ， 而 不 是 针对 
实现 编程 。 如 条 将 这 条 诛 则 运用 到 前 面 的 代码 中 ， 则 意味 看 我 们 将 从 记录 需 组 件 中 
提取 出 一 个 接口 ， 然 后 将 对 这 个 接口 的 引用 注入 业务 类 中 。 


public class BusinessTask 
{ 
private ILogger logger; 


Public BusinessTask (ILogger logger) 
| 
// Get hold of the dependency 
_logger = logger; 
} 


Public void Perform!() 
| 
// Perform task 


// Use the (injected) dependency 
Jogger.Log ( Done ) 7 
} 
} 
记录 器 功能 被 抽象 为 ILogger 接口 后 ， 通 过 构造 函数 注入 。 然 后 ， 我 们 可 得 知 
以 下 两 点 。 
e 首先 ， 实 例 化 记录 堪 的 工作 已 被 移出 了 业务 类 。 
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。 其 次 , 业务 类 可 以 透明 地 使 用 现在 或 者 未 来 的 任何 类 ， 只 要 后 者 实现 了 该 接 
口 印 可 。 
这 是 依赖 注入 的 一 种 基本 形式 ， 有 时 也 称 为 穷人 版 的 依赖 注入 ， 这 是 为 了 强调 
这 种 形式 只 是 依赖 注入 最 基本 的 实现 形式 ， 但 是 也 是 可 以 工作 的 。 


2. DI 框架 简介 


和 梓 设 计 为 接收 外 部 依赖 的 闫 将 创建 所 有 必要 实例 的 工作 交 给 了 调用 代码 。 但 是 ， 
如 条 过 度 使 用 DI 模式， 在 得 到 要 注入 的 实例 之 前 ， 震 要 编 与 的 代码 量 可 能 会 太 大 。 
例如 ， 业 务 类 依赖 于 记录 器 ， 而 记录 器 依 赖 于 数据 源 提 供 程 序 ， 数 据 源 提供 程序 叉 
可 能 有 其 他 依赖 ， 以 此 类 推 。 

为 了 降低 类 似 场景 的 工作 量 , 可 以 使 用 DI 框架 。DI 框架 使 用 反射 (更 有 可 能 使 
用 动态 编 详 的 代码 ) 来 返回 期 望 的 实例 ， 而 我 们 只 需要 编写 一 行 代 码 而 已 。DI 框 巢 
有 时 也 称 为 控制 反 转 (Cnversion-ofControl，IoC) 框 架 。 


Var logger = SomeFrameworkloC.Resolve (typeof (ILogger))}); 


DI 框架 实际 上 就 是 将 抽象 类 型 (通常 是 一 个 接口 ) 映 射 到 一 个 具体 类 型 。 每 当代 
码 中 请 求 一 个 已 知 的 抽象 类 型 时 , 框架 就 会 创建 并 返回 映射 的 具体 类 型 的 一 个 实例 。 
注意 ，DI 框架 的 根 对 象 常 被 称 为 容器 。 


3. Service Locator 模式 


在 以 松散 耦合 的 方式 调用 外 部 依赖 时 ， 依 赖 注 入 并 非 唯 一 可 行 的 方式 。 还 有 一 
种 模式 称 为 Service Locator。 下 和 而 显示 了 如 何 让 前 和 面 的 示例 类 使 用 Service Locator。 


public class BusinessTask 


{ 
Public void Pertorm () 
{ 
// Perform task 
// Get the reference to the logger 
var logger = ServiceLocator.GetService (typeof (ILogger))}); 
// Use the (located) dependency 
logger.Log ("Done™); 
} 
} 


ServiceLocator 伪 类 代表 的 基础 结构 能 够 创建 与 指定 抽象 类 型 几 配 的 实例 。DI 
与 Service Locator 的 关键 区 别 在 于 ，DI 要 求 相 应 地 设计 外 围 代 码 ; 构造 函数 和 其 他 
方法 的 签名 可 能 发 生变 化 。Service Locator 更 加 保守 ， 但 是 得 到 的 代码 的 可 读 性 要 
者 一 些 ， 因 为 开发 人 员 和 需要 研究 完整 的 源 代码 来 确定 依赖 。 男 外 ， 当 在 庞大 的 现 有 
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代 人 码 库 中 重 构 依赖 时 ，Service Locator 是 一 个 理想 的 选择 。 
在 ASPNET Core 中 ，RequestServices 对 象 在 HTTP 上 下 文中 扮演 Service 
Locator 的 角色 。 下 面 给 出 了 一 些 示 例 代 但 。 


public void Pertorm() 
| 
// Perform task 


// Get the reference to the logger 
Var logger = HttpContext.RequestServices.GetService<ILogger>();} 


// Use the (located) dependency 
Jogger.Log("Done™); 
} 


注意 ， 示 例 代 码 被 假定 为 东 个 控制 只 类 的 一 部 分 ;因此 ，HttpContext 应 该 是 
Controller 基 类 的 一 个 属性 。 


7.1.2 ASPNET Core DI 系统 概述 

ASPNET Core 目 市 一 个 DI 框架 ， 在 应 用 程序 局 动 时 初始 化 。 下 和 面 介绍 该 DI 
框架 的 特征 。 

1. 预定 义 依赖 


当 容 器 变 得 对 应 用 程序 代码 可 用 时 , 就 已 经 包含 了 一 些 配 秆 好 的 依赖 , 如 表 7-1 
所 不。 


表 7-1 ASP.NET Core DI 系统 中 默认 映射 的 抽象 类 型 


抽象 类 型 摘 述 
IApplicationBuilder 此 关 型 提供 了 配置 应 用 程序 的 请 求 常 道 的 机 制 
ILoggerFactory 此 类 型 提供 了 创建 记录 幽 组 件 的 模式 


IHostingEnvironment | ”此 关 型 提供 管理 应 用 程序 运行 的 Web 箱 主 环境 的 信息 


在 ASPNET Core 应 用 程序 中 ， 可 以 把 上 述 任何 类 型 注入 任何 有 效 的 代码 注入 
点 ， 并 不 需要 预先 进行 配置 ( 稍 后 将 详细 介绍 注入 点 )。 不 过 ， 为 了 能 够 注入 其 他 任 
何 类 型 ， 必 须 首先 进行 注册 。 


2. 注册 自 定义 依赖 


可 以 使 用 两 种 役 此 不 互 斥 的 方式 在 ASPNET Core DI 系统 中 注册 类 型 。 为 了 注 
有 册 类 型 ， 需 要 让 系统 知道 如 何 将 一 个 抽象 类 型 解析 为 一 个 具体 类 型 。 这 种 映射 可 以 
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前 人 态 设 及 定 ? 也 可 以 动态 :ns 决定 | 
静态 映射 通 沼 在 局 动 类 的 ConfigureServices 方法 中 实现 。 


public class Startup 


{ 
Public void ConfiqureServices (IServiceCollection services) 
{ 
// Bind the concrete type CustomerService to the ICustomerService interface 
Services.AddTransijent<ICustomerService, CustomerService>(),;} 
} 
} 


使 用 DI 系统 定义 的 Addxxx 扩展 方法 来 绑 定 类 pgley mpeg tts 
IServiceCollection 接口 上 定义 的 。 上 和 耐 代 码 的 效果 是 ， 每 当 请 求 一 个 实现 了 
ICustomerService 的 类 型 的 实例 时 ， 系 统 将 返回 CustomerService 的 一 个 实 A 
是 ，AddTransient 方法 确保 了 每 次 都 会 返回 CustomerService 类 型 的 一 个 新 实例 。 

也 有 其 他 生存 期 选项 可 用 。 

抽象 类 型 的 静态 解析 有 时 有 一 定 的 局 限 性 。 事 实 上 ， 如 条 需要 根据 运行 时 条 件 
将 类型 工 解析 为 不 同 的 类 型 ， 应 该 怎么 办 ? 这 时 就 需要 用 到 动态 解析 ; 动态 解析 多 
许 指定 一 个 回调 函数 来 解析 依赖 。 


public void ConfigureServices (IServiceCollection services) 


{ 
Services.AddTransient<ICustomerService> (provider 三 > 
{ 
// Place your logic here to decide how to resolve ICustomerService. 
i (SomeRunNntimeConditionHolds()) 
return new CustomerServiceMatchingRuntimeCondition(); 
else 
return new DefaultCustomerServicel(); 
}); 
} 


企 现 实 中 ， 需 要 传递 一 旦 运行 时 数据 来 对 条 件 求 值 。 为 了 在 回调 函数 内 获取 
HTTP 上 下 文 ， 需 要 使 用 服务 定位 右 API。 


Public void ConfigqureServices (lIServiceCollection services) 
{ 
Services.AddTransient<ICustomerService> (provider 三 > 
{ 
// Place your logic here to decide how to resolve ICustomerService. 
Var context = provider.GetRequiredService<IHttpContextAccessor> ()}); 
if (SomeRuntimeConditionHolds (context .HttpContext .User)) 
return new CustomerServiceMatchingRuntimeCondition(); 


Else ... 


}); 


1953 


第 川 部 分 ”路 领域 关注 点 


注意 : 
闪 须 调用 IServiceCollection 的 某 个 Addeex 扩展 方法 来 把 自己 的 类 型 添加 到 DI 
系统 中 ， 以 及 将 任何 系统 抽 荣 类 型 绑 定 到 不 同 的 实现 。 


3. 依赖 的 生存 期 


在 ASPNET Core 中 ， 有 几 种 不 同 的 方法 来 加 DI 系统 请 求 映 射 的 具体 类 型 的 实 
例 。 表 7-2 列 出 了 这 几 种 方法 。 


表 7-2 DI 创建 的 实例 的 生存 期 选项 
方法 摘 述 
AddTransient 调用 方 在 每 次 调用 时 ， 收 到 指定 类 型 的 一 个 新 实例 
AddSingleton 调用 方 收 到 指定 类 型 的 相同 实例 ， 该 实例 在 第 一 次 请 求 时 创建 。 无 论 关 型 
是 什么 ， 每 个 应 用 程序 都 将 得 到 其 目 己 的 实例 
AddScoped 与 AddSingleton 相同 ， 只 不 过 其 作用 域 为 当前 请 来 


注意 ， 通 过 使 用 AddSingleton 方法 的 重 载 函数 ， 还 可 以 指定 为 后 续 调 用 返回 的 
上 其 体 实例 。 当 需要 让 人 返回 的 对 象 配 置 为 特定 的 状态 时 ， 这 种 方法 很 有 帮助 。 
public void ConfigureServices (IServiceCollection services) 
// Singleton 
services.AddSingleton<ICustomerservice, CustomerService>(); 


// Custom instance 
Var jnstance = new CustomerService();} 
instance.SomeProperty = ...? 


Services.AddSingleton<ICustomerService> (instance); 


} 


在 这 里 ， 首 先 创建 实例 ， 并 在 其 中 存储 期 望 的 状态 ， 然 后 将 其 传递 给 
Addsingleton 。 


| 
| 
站 i 
kk 重 二 
有 | 
下 i 
.i f 
i C3 | 
， 2 


要 特别 注意 ， 当 注册 的 组 件 具 有 指定 的 生存 期 时 ， 不 能 依赖 于 其 他 生存 期 更 短 
的 组 件 。 换 名 话说 ， 不 能 将 生存 期 为 Transient 或 Scoped 的 组 件 注入 Singleton 中 。 如 
果 这 么 做 ， 可 能 会 性 致 应 用 程 厚 不 一 致 ， 因 为 对 Singleton 的 依赖 将 使 得 Transient 
或 Scoped 实例 的 生存 时 间 超 过 其 期 望 的 生存 期 .这 不 一 定 在 应 用 程序 中 导致 可 见 的 
bug, 但 是 有 可 能 导致 Singleton 处 理 错误 的 对 象 (就 应 用 程序 而 言 是 错误 的 对 和 象 )。 一 
般 来 说 ， 每 当 链 式 对 象 的 生存 期 不 相同 时 ， 就 会 出 现 这 种 问题 。 
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4. 连接 到 外 部 DI 框架 


ASPNET Core 中 的 DI 系 统 是 针对 ASPNET 的 需求 定制 的 , 所 以 可 能 没有 提供 
你 使 用 其 他 DI 框架 时 所 熟悉 的 全 部 功能 。ASPNET Core 的 好 处 在 于 ， 可 以 插入 任 
意外 部 DI 框架， 只 要 该 框架 已 经 被 移植 到 .NET Core 上 且 有 一 个 连接 器 。 和 下面 的 代 
码 显 示 了 如 何 插入 一 个 外 部 DI 框架 。 

public IServiceProvider ConfigureServices (IServiceCollection services) 

{ 


// Configure the ASP.NET Core native DI system 
Services.AddTransient<ICustomerService, CustomerService>(); 


// Import existing mappings in the external DI framework 
Var builder = new ContainerBuilder ();} 

builder.Populate (services); 

Var container = builder.Build(); 


/ Replace the service provider for the rest of the pipeline to use 
return container.Resolve<IServiceProvider>();} 


} 


当 想 要 在 应 用 程序 中 使 用 一 个 外 部 DI 框架 时 ， 首 先 需要 在 启动 类 中 修改 
ConfigureServices 方法 的 签名 。 现在,， 访 方法 不 能 为 void， 而 是 必须 返回 IServiceProvider。 
在 上 面 的 代码 中 ， 类 ContainerBuilder 是 我 们 想 要 插入 的 特定 DI 框架 (如 Autofac) 的 
连接 器 。Populate 方法 将 所 有 待定 类 型 映射 导入 Autofac 内 ,然后 Autofac 框架 被 用 
来 解析 IServiceProvider 上 的 根 依赖 。 管 道 的 其 余部 分 将 在 内 部 使 用 这 个 接口 来 解析 


7.1.3 DI 容器 的 各 个 方面 


在 ASPNET Core 中 ， 如 条 让 DI 容 礁 实例 化 一 个 还 没有 注册 的 关 型 ， 它 将 返回 
null。 如 果 为 同一 个 抽象 类 型 注册 了 多 个 具体 类 型 ， 那 么 DI 容 堆 将 返回 最 后 注册 的 
类 型 的 一 个 实例 。 如 果 由 于 二 义 性 或 者 参数 不 莱 容 ， 导 人 致 无 法 解析 构造 冰 数 ， 那 么 
DI 容 涡 将 抛 出 一 个 异常 。 

当 要 处 理 复 杂 的 场景 时 , 可 通过 编程 获取 为 给 定 抽象 类 型 注册 的 所 有 其 体 类 型 。 
IServiceProvider 接口 上 定义 的 GetServices<TAbstract> 方 法 可 返回 这 个 具体 类 型 列 
表 。 最 后 ,一 些 流行 的 DI 框架 允许 开发 人 员 根 据 键 或 者 条 件 注册 类 型 . ASPNET Core 
不 文 持 这 种 场景 。 如 果 这 项 功能 对 于 应 用 程序 很 关键 ， 那 么 可 以 考虑 为 相关 类 型 创 
建 一 个 专门 的 工厂 类 。 
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7.1.4 在 层 中 注入 数据 和 服务 


在 DI 系统 中 注册 了 一 个 服务 之 后 ， 要 使 用 该 服务 ， 只 需要 在 必要 的 位 置 请 求 
一 个 实例 。 在 ASPNET Core 中 ， 可 以 将 服务 注入 管道 中 ， 只 需要 通过 Configure 方 
法 或 中 间 件 类 将 其 注入 控制 器 或 视图 中 。 

1. 注入 技术 

将 服务 注入 组 件 中 的 主要 方式 是 通过 其 构造 函数 注入 。 中 辐 件 类 、 控 制 占 和 视图 
总 是 通过 DI 系统 实例 化 ， 其 签名 中 列 出 的 任何 额外 的 参数 将 被 目 动 解析 。 

除了 构造 图 数 注入 , 在 控制 器 类 中 , 还 可 以 使 用 FromServices 特性 来 获得 实例 ， 
以 及 使 用 Service Locator 接口 。 注意 ， 当 需要 检查 运行 时 条 件 来 恰当 地 解析 依赖 时 ， 
需要 使 用 Service Locator 接口 。 

2. 在 管道 中 注入 服务 


可 以 把 服务 注入 ASPNET Core 应 用 程序 的 启动 类 中 。 不 过 ， 在 这 个 时 候 ， 只 
能 使 用 构造 函数 注入 ， 并 且 只 能 注入 表 7-1 中 列 出 的 类 型 。 
// Constructor injection 
public Startup (IHostingEnvironment env, lILoggerFactory loggerFactory) 
{ 
// Initialize the application 
} 
接 下 来 ， 在 使 用 前 处 理 和 后 处 理 请 求 的 组 件 来 配置 管道 时 ， 可 以 通过 某 个 中 间 
件 类 (如 果 使 用 了 这 样 的 类 ) 的 构造 函数 或 者 使 用 Service Locator 方法 来 注入 依赖 
app.Use ((context, next) 三 > 
{ 
VAar Service = COmntLeXtL .ReGuestSeTrVLCeS -GetSerVlICe<ICUStOmeTSeITVILCE> () ， 
a 
}); 
3. 在 控制 器 中 注入 服务 
在 MVC 应 用 程序 模型 中 ， 服 务 注入 主要 是 通过 控制 器 类 的 构造 函数 实现 的 。 
下 向 给 出 了 一 个 示例 控制 占 。 
Public class CustomerCcontroller : Controller 
{ 


private readonly ICustomerService services 


// Service injection 
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Public CustomerCcontroller{(ICustomerService service) 
{ 
_SeTVICe = Service; 
} 
} 


万 外 ， 还 可 以 畴 兰 模 型 绑 定 机 制 ， 将 方法 参数 映射 到 成 员 。 
public IActionResult Indexl 
[FromServices| ICustomerService service) 

{ 

} 

使 用 FromServices 特性 时 ，DI 系统 将 创建 并 返回 与 ICustomerService 接口 天 联 
的 具体 其 型 的 一 个 实例 。 最 后 ， 在 控制 器 方法 体内 ， 总 是 可 以 引用 HITP 上 下 文 对 
象 及 其 RequestServices 对 象 ， 以 使 用 Service Locator API。 


4. 在 视图 中 注入 服务 


在 第 5 章 看 到 ， 在 Razor 视图 中 可 以 使 用 @inject 指令 ， 强 制 DI 系统 返回 指定 
类 型 的 一 个 实例 ， 并 将 其 绑 定 到 给 定 的 属性 。 


Qinject ICustomerService Service 


这 行 代 人 码 的 效果 是 使 得 一 个 名 为 Service 的 属性 在 Razor 视图 内 可 用 , 该 属性 已 
被 设 为 DI 解析 的 ICustomerService 类 型 的 实例 。 实 例 的 生存 期 取决 于 DI 容器 内 
ICustomerService 类 型 的 配置 。 


7.2 ”收集 配置 数据 


任何 真实 网 站 的 结构 都 是 让 一 个 中 心 引 擎 通过 基于 HTTP 的 端点 连接 到 外 部 世 
界 。 当 使 用 ASPNET MVC 作为 应 用 程序 模型 时 ， 这 些 疹 点 被 实现 为 控制 器 。 如 第 4 
章 所 示 ， 控 制 右 处 理 传 入 的 请 求 并 生成 传 出 的 啊 应 。 包 含 网 站 后 台 逐 辑 的 中 心 引 擎 
的 行为 并 不 是 完全 硬 编 码 的 ， 而 是 可 能 包含 一 些 参数 信息 ， 并 从 外 部 数据 源 读 取 这 
些 参数 的 值 一 一 这 是 很 合理 的 。 

在 经 典 ASPNET 应 用 程序 中 , 系统 对 获取 配置 数据 的 文 持 仅 限 于 使 用 一 个 基本 
API 在 web.config 文件 中 读 写 数据 。 在 局 动 应 用 程序 时 ， 开 发 人 员 通 第 会 将 所 有 信 
县 收集 到 一 个 全 局 的 数据 结构 中 ， 该 数据 结构 可 在 应 用 程序 的 任何 位 置 调 用 。 在 
ASPNET Core 中 ,不 再 有 web.config 文件 ， 但 是 提供 了 一 个 更 加 丰富 、 更 加 复杂 的 
基础 结构 ， 用 于 处 理 配 置 数据 。 
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7.2.1 支持 的 数据 提供 程序 


ASPNET Core 应 用 程序 的 配置 基于 一 个 名 称 - 值 对 列表 ， 这 些 名 称 - 值 对 是 在 运 
行 时 从 多 个 数据 源 收 集 得 到 的 。 最 常见 的 场景 是 从 JSON 文件 读 取 配置 数据 。 但 是 ， 
也 存在 许多 其 他 选项 ， 表 7-3 列 出 了 最 重要 的 选项 。 


表 7-3 ASP.NET Core 中 最 单 见 的 配置 数据 源 


数据 源 拉 述 
文本 文件 从 专门 的 文件 格式 读 取 数 据 ， 包 括 JSON、XML 和 INI 格式 
环境 变量 从 宿主 服务 器 上 配置 的 环境 变量 读 取 数 据 
内 存 字 暴 从 内 存 中 的 NET 字典 类 读 取 数 据 


另外 ， 配 置 API 提供 了 内 置 的 命令 行 参 数 数据 提供 程序 ， 可 从 命令 行 参 数 和 直接 
生成 名 称 - 值 配置 对 。 但 是 ， 这 个 选项 在 ASPNET 应 用 程序 中 不 是 特别 常用 ， 因 为 
对 于 启动 Web 应 用 程序 的 控制 台 应 用 程序 命令 行 ,我 们 没有 多 少 控制 权 。 命 令 行 提 
供 程序 在 控制 台 应 用 程序 开发 中 要 更 加 常用 。 


1. JSON 数据 提供 程序 


任何 JSON 文件 都 可 以 成 为 ASPNET Core 应 用 程序 的 配置 数据 源 。 文 件 的 结构 
完全 由 目 己 决定 ， 并 且 可 以 包含 任何 层次 的 散人 套 。 在 搜索 给 定 的 JSON 文件 时 ， 首 
先 从 应 用 程序 局 动 时 指定 的 内 容 根 文件 夹 开始 。 

稍 后 将 详细 介绍 , 完整 的 配置 数据 集 是 由 从 多 个 数据 源 得 到 的 数据 联合 产生 的 ， 
并 被 构建 成 一 个 分 层 的 文档 对 象 模型 (Document Object Model，DOM)。 这 意味 着 在 
构建 需要 的 配置 树 时 ， 可 以 使 用 任意 多 的 JSON 文件 ， 并 且 每 个 文件 都 可 以 有 自己 
的 目 定义 模式 。 


2. 环境 变量 提供 程序 


在 服务 问 实 例 中 定义 的 任何 环境 变量 玫 可 科 湛 加 到 配置 树 中 。 我 们 要 做 的 束 是 
通过 编程 把 这 些 变量 添加 到 配置 树 。 环 境 变 量 是 作为 单个 其 添加 的 。 如 条 需要 过 滤 ， 
最 好 使 用 一 个 内 存 捉 供 程 序 ， 并 将 选 定 的 环境 变量 添加 到 字典 中 。 


3. 内 存 提供 程序 


内 存 提 供 程 序 是 名 称 - 值 对 的 一 个 普通 字典 ， 通 过 编程 添加 内 容 ， 并 航 添 加 到 配 
痢 树 中 。 获 取 和 实际 的 值 并 存储 到 字典 中 的 工作 完全 由 开发 人 员 人 负责 。 因 此 ， 通 过 内 
存 提供 程序 传递 的 数据 可 以 是 不 变 的 ， 或 者 从 任意 持久 数据 存储 读 取 。 
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4. 目 定 义 配 置 提供 程序 


除了 使 用 预定 义 的 配置 数据 提供 程序 ， 也 可 以 创建 目 己 的 提供 程序 。 提 供 程 序 
是 一 个 实现 了 IConfiegurationSource 接口 的 类 。 但 是 ， 在 其 实现 中 ， 还 需要 引用 一 个 
继承 日 ConfigurationProvider 的 目 定 义 类 。 

日 定义 配 秆 提供 程序 的 一 个 很 常见 的 例子 是 使 用 专门 的 数据 库 表 来 读 取 数据 。 
提供 程序 隐藏 了 相关 数据 库 表 的 模式 和 布局 。 为 了 创建 数据 库 驱 动 的 提供 程序 ， 肯 
先 创建 一 个 配 管 源 对 象 ， 这 只 是 配 秆 提供 程序 的 一 个 封装 器 。 


public class MyDatabaseConfigSource : IConfigurationSource 


{ 
Public IConfigurationProvider Build(IlIConfigqgurationBulilder builder) 
L 
return new MyDatabaseConfigProvider () 7 
} 
} 


在 配置 提供 程序 中 实际 执行 数据 的 检索 。 配 置 提供 程序 包含 并 隐藏 了 要 使 用 的 
DbContext 的 细节 ， 以 及 表 名 、 列 名 和 连接 字符 串 ( 示 例 代 码 段 使 用 了 第 9 章 将 会 介 
绍 的 Entity Framework Core)。 


public class MyDatabaseConfigProvider : ConfigqurationProvider 


{ 
private const string ConnectionSstring = "..."} 
Public override void Load () 
| 
USinNng (var db = new MyDatabaseContext (Connectionstring)) 
{ 
db.Database.EnsureCreated (); 
Data = lIdb.Values.Anyl() 
? GetDefaultValues!l() 
: db.Values.ToDictionary(c => c.Id, Cc => c.Value); 
} 
} 
private IDictionary<string,: string> GetDefaultValues () 
{ 
// Pseudo code for determining default Values to use 
var values = DetermineDefaultValues ();} 
return values; 
} 
} 


示例 代码 段 缺少 DbContext 类 的 实现 ， 也 就 是 处 理 连接 字符 串 、 表 和 列 的 地 
方 。 一 般 来 说 ， 我 们 假设 MyDatabaseContext 是 另外 一 段 需 要 使 用 的 代码 。 使 用 
MyDatabaseContext 的 代码 段 引 用 了 一 个 名 为 Values 的 数据 库 表 。 
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st 
壮 忆 : 


如 果 找 到 了 一 种 方式 来 把 DbContextOptions 对 象 作 为 参数 传递 给 提供 程序 ， 那 
么 甚至 可 以 使 用 一 个 通用 程度 相当 高 的 基于 EF 的 提供 程序 。 以 下 网 址 提供 了 这 种 
方法 的 一 个 示例 : http://bit.ly/2uQBJmK. 


7.2.2 ”构建 配置 文档 对 象 模型 


配置 数据 提供 程序 是 必须 有 的 组 件 , 但 是 对 于 在 Web 应 用 程序 中 检索 和 使 用 参 
数 信息 还 是 不 够 的 。 选 定 的 提供 程序 能 够 提供 的 所 有 信息 必须 被 聚合 到 一 个 很 可 能 
分 层 的 DOM 中 。 


1. 创建 配置 根 对 象 


配置 数据 常常 在 启动 类 的 构造 函数 中 构建 ， 如 下 所 示 。 注 意 ， 只 有 当 需 要 在 基 
个 地 方 使 用 IHostingEnvironment 接口 时 ， 才 必须 注入 该 接口 。 通 党 ， 只 有 设置 基础 
路 径 来 定位 JSON 文件 或 其 他 配置 文件 时 ， 才 需要 注入 IHostingEnvironment。 
public IConfigqurationRoot Configuration { get } 
public Startup (IHostingEnvironment env) 
{ 
Var dom = new ConfigurationBulilder () 
-SetBasePath (env .ContentRootPath) 
-AddJsonFilel("MyAppSettings.Json") 
-AddInMemoryCollection (new Dictionary<string, string> { { "Timezone™, "+]™ } }) 


.AddEnvironmentVariables() 
.Buildl(); 


// Save the configuration root object to a startup member for further references 
Confiquration = dom; 


} 

ConfigurationBuilder 类 人 负 贡 聚合 配 荀 值 并 构建 DOM。 聚 合 的 数据 应 该 保存 到 局 
动 类 中 ,以便 后 和 面 在 初始化 党 思 时 使 用 。 下 一 个 要 处 理 的 问题 是 如 何 读 取 配 管 数据 ; 
对 配置 根 对 象 的 引用 仅仅 是 用 来 访问 实际 值 的 工具 。 不 过 ， 在 介绍 相关 内 容 之 前 ， 
需要 先 对 配置 中 使 用 的 文本 文件 作 一 些 说 明 。 


2. 配置 文件 的 高 级 方面 
创建 自己 的 数据 提供 程序 时 ， 可 采用 任意 格式 存储 配置 ， 且 仍然 能 够 将 存储 的 


数据 作为 名 称 - 值 对 绑 定 到 标准 的 配置 DOM。ASPNET Core 直接 支持 JSON、XML 
和 INI 格式 。 


要 把 每 种 格式 添加 到 配置 构建 问 ， 需 要 使 用 一 个 专门 的 扩展 方法 ， 如 AddJsonFile、 
AddXmlFile 或 AddImiFile。 这 些 方 法 的 签名 是 相同 的 ， 除 了 文件 名 以 外 ， 还 包含 两 
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个 额外 的 布尔 值 参 数 。 


// Extension method of the IConfigurationBuilder type 

public static IConfigurationBuilder AddJsonFile (this IConfigurationBuilder builder, 
string path, 
bool optijonal, 
bool reloadOnChange).; 


第 一 个 布尔 值 参 数 指出 该 文件 是 否 是 可 选 的 。 如 条 不 是 可 选 鸭 ， 那 么 当 找 不 到 
文件 时 ， 就 抛 出 一 个 异常 。 第 二 个 参数 reloadOnChange 指定 是 否 应 该 监控 该 文件 的 
变化 。 如 果 监 控 ， 那 么 每 当 文 件 发 生变 化 时 ， 束 日 动 重 建 配 置 树 来 反映 这 些 变 化 。 

Var builder = new ConfijgurationBuilder() 

.SetBasePath (env .ContentRootPath) 


.AddJsonFile ("MyAppSettings.Json"y, optional: true, reloadonChange: true); 
configuration = builder.Build(); 


因此 ， 这 是 从 文本 文件 加 载 配 置 数 据 的 一 种 更 具 弹 性 的 方法 ， 不 管 文 件 格式 是 
JSON、XML 还 是 INI。 


a 本 
一 ) 土 电 : 


ASPNET Core 也 支持 从 环境 特定 的 文件 中 获取 设置 。 这 意味 着 除了 
MyAppSettings.json， 还 可 以 有 MyAppSettings.Development.json， 可 能 还 有 一 个 
MyAppSettings.Staging.json。 我 们 只 需要 添加 自己 可 能 需要 的 所 有 JSON 文件 ， 系统, 
将 从 中 选 出 看 起 来 适合 给 定 上 下 文 的 一 个 文件 。 应 用 程序 当前 运行 的 环境 是 通过 
ASPNETCORE ENVIROMENT 环境 变量 的 值 确定 的 。 在 Visual Studio 2017 中 ， 可 
以 在 项 目的 属性 页 中 直接 设置 该 变量 的 值 。 在 JIIS 或 Azure App Service 中 ， 可 通过 
相应 的 门户 添加 该 环境 变量 。 


3. 读 取 配置 数据 


要 在 代码 中 读 取 配 置 数据 ， 需 要 使 用 配置 根 对 象 的 GetSection 方法 ， 并 向 其 伟 
递 一 个 路 径 字符 串 ， 准 确 指出 想 要 读 取 的 信息 。 为 了 在 分 层 模式 中 限定 属性 ， 需 要 
使 用 “:( 冒 号 )”。 假 设 JSON 文件 如 下 所 示 : 


{ 
“Paglng : 1 
"PageSjze™ : "20" 
}, 
“sorting™ : | 
"enabled™ : "false”"™ 
} 
} 


证 取 设 置 时 , 可 以 采取 许多 不 同 的 方式 , 上 只 要 知道 JSON 模式 中 值 的 路 径 即 可 。 
例如 ，paging:pageSize 是 读 取 页 面 大 小 的 路 径 字 符 串 。 指 定 的 路 径 字 符 串 是 通过 
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聚合 所 有 定义 的 数据 源 得 到 的 ， 并 应 用 到 当前 的 配置 DOM。 路 径 字符 串 不 区 分 大 
齐全 
最 简单 的 读 取 设置 的 方法 是 使 用 索引 费 API， 如 下 所 示 。 


// The returned value is a string 
Var pageSize = Configurationl"paging:pageSsSize™ |} 


需要 香 点 注意 ， 默 认 情 况 下 ， 设 管 是 作为 普通 字符 串 返 回 的 ， 必 须 在 代 人 码 中 将 其 
转换 为 实际 的 具体 类 型 ， 然 后 才能 进一步 使 用 。 为 外 ， 还 可 以 使 用 一 个 强 类 型 的 API。 


// The returned value is an integer (If conversion is possible) 
Var pagesize = Configuration.GetValue<int>("paging:pageSsize 1) 7， 


GetSection 方法 允许 选择 整个 配置 子 树 , 然后 就 可 以 使 用 索引 器 和 强 类 型 的 API 
进行 操作 。 

var pageSize = Configuration.GetSection ("Paging") .GetValue<int> ("PageSize"); 

最 后 ， 还 可 以 使 用 GetValue 方法 和 Value 属性 。 二 者 都 会 把 设置 的 值 返 回 为 一 
个 字符 串 。 注 意 ，GetSection 方法 是 配置 树 上 的 一 个 通用 但 询 工 具 ， 并 不 是 仪 用 于 
JSON 文件 的 。 


注意 : 
配置 API 被 设计 为 是 只 读 的 。 但 是 ， 这 只 是 意味 着 不 能 使 用 API 写 入 配置 的 数 
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据 源 。 如 果 有 田 一 种 方式 可 编辑 数据 源 的 内 容 ( 如 通过 编程 尾 盖 文本 文件 ,或 者 使 用 
数据 库 更 新 )， 那 么 系统 允许 重新 加 载 配 置 树 。 只 需要 调用 IConfigurationRoot 对 误 
的 Reload 方法 即 可 。 


7.2.3” 传 速配 置 数 据 


通过 路 任 字 从 串 读 取 配 车 数据 并 不 是 特别 友好 (虽然 这 是 一 种 有 用 的 低级 工 
具 )。ASPNET Core 提供 了 一 种 机 制 将 配置 数据 绑 定 到 强 类 型 的 变量 和 成 员 。 不 过 ， 
在 深入 探讨 相关 内 容 之 前 , 我们 应 该 先 了 解 如 何 把 配 症 数 据 传递 给 控制 项 和 视图 。 


1. 注入 配置 数据 


到 目前 为 止 ， 我 们 在 启动 类 中 使 有 配置 API。 在 启动 类 中 ， 我 们 配置 应 用 各 
序 的 管道 ， 这 是 读 取 配置 数据 的 一 个 很 好 的 位 置 。 但 是 ， 更 常见 的 情况 是 ， 需 要 
在 控制 器 方法 和 视图 中 读 取 配 置 数据 。 对 于 这 种 情况 ， 有 一 种 老 方法 和 一 种 新 方 
法 可 用 。 

老 方法 是 使 IConfigurationRoot 对 象 成 为 在 应 用 程序 任何 位 置 都 可 见 的 全 局 对 
象 。 这 种 方法 可 以 起 到 效果 ， 但 作为 一 种 遗留 方法 ， 已 经 不 推荐 采用 它 。 新 方法 是 
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使 用 DI 系统 ， 让 配置 根 对 象 对 控制 器 和 视图 可 用 。 


public class HomeController : Controller 


{ 
private IConfigurationRoot Confjguration { get; 上 } 
Publijic HomeController{(IlConfigurationRoot config) 
{ 
Configqguration = contfig; 
} 
} 


每 当 创 建 HomeController 类 的 一 个 实例 时 ， 束 会 注入 配置 根 对 象 。 但 是 ， 为 了 
避 人 饮 接 收 到 null 引用 ， 必 须 首 先 在 DI 系统 中 把 局 动 类 中 创建 的 配置 根 对 象 注册 为 
一 个 单 例 。 


Services.AddSingleton<IConfigurationRoot> (Confijgquration); 


需要 把 这 行 代码 放 到 局 动 类 的 ConfigureServices 方法 中 。 注 意 ，Configuration 
对 象 就 是 在 局 动 类 的 构造 函数 中 创建 的 配置 根 对 象 。 


2. 将 配置 映射 到 POCO 类 


在 经 典 ASPNET MVC 中 ， 处 理 配置 数据 的 最 佳 实践 是 ， 在 应 用 程序 局 动 时 ， 
一 次 性 将 所 有 数据 加 载 到 一 个 全 局 容器 对 象 中 。 该 全 局 对 象 可 在 控制 器 方法 内 访 
问 ， 其 内 容 可 作为 参数 注入 后 六 类 ( 如 存储 库 ) 其 全 视图 中 。 在 经 典 ASPNET MVC 
中 ,将 基于 字符 串 的 松 敌 数据 映射 到 全 局 容 右 的 强 类 型 属性 的 开销 完全 被 交 给 了 开 

相反 ， 在 ASPNET Core 中 ， 可 以 使 用 所 谓 的 Options 模式 ， 将 配置 根 DOM 的 
名 称 - 值 对 自动 绑 定 到 配置 容器 模型 。Options 模式 是 下 列 编 码 策略 的 描述 性 名 称 。 

Public void ConfigureServices (IServiceCollection services) 

{ 


// Initializes the Options subsystem 
services.Addoptions () ; 


// Maps the specified segment of the configuration DOM to the given type. 
// NOTE: Configuration used below is the configuration root created 

/i in the constructor of the startup class 
Services.Configure<PagingOptions> (Configquration.GetSection("paging )); 


} 


初始 化 Options 子 系统 之 后 ， 束 可 以 将 该 子 系 统 与 从 配置 DOM 的 指定 方 中 读 
取 的 所 有 值 进行 绑 定 ， 这 些 值 会 被 读 取 到 作为 Configure<T> 方 法 参数 的 类 的 公有 成 
员 中 。 绑 定 采 用 与 控制 匿 的 模型 绑 定 相同 的 规则 ， 并 递归 应 用 到 认 僚 的 对 象 。 如 果 
由 于 数据 和 绑 定 对 象 的 结构 怕 因 ， 无 法 完成 绑 定 ， 那 么 绑 定 了 怠 会 悄悄 失败 。 

PagingOptions 是 一 个 POCO 类 ， 用 于 存储 一 些 ( 甚 全 全 部 ) 配 置 设置 。 下 面 给 出 
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了 该 类 的 一 种 可 能 的 实现 : 


public class PagingOptions 
{ 
Public int PageSize { get; set; 上 } 


} 


配置 API 的 整体 行为 与 模型 绑 定 在 控制 器 级 别处 理 请 求 时 的 行为 很 相似 。 要 在 
控制 人 项 和 视 钢 中 使 用 配置 的 强 类 型 对 象 ， 束 要 把 强 关 型 对 象 注 入 DI 系统 。 这 吏 必 须 
要 倍 助 于 IOptions<T> 抽 象 类 型 。 

将 IOptions 类 型 注册 到 DI 系统 中 正 是 AddOptions 扩展 方法 的 作用 。 因 此 ， 剩 
下 要 做 的 就 是 在 有 需要 的 地 方 注 入 IOptions<T>。 


// PagingOptions is an internal member of the controller class 
protected Pagingoptions Configuration 1{ get; set; 1 


public CustomerCcontroller (IOptions<Pagingoptions> contig) 
{ 

PagingOptions = config.Value; 
} 


如 果 在 所 有 控制 占 中 大 量 使 用 Options 模式 ， 那 么 可 以 考虑 将 上 向 看 到 的 选项 
属性 移动 到 攻 个 基 类 中 ， 并 让 控制 右 类 继承 该 基 类 ，。 

最 后 ， 在 Razor 视图 中 ， 只 需要 使 用 @inject 指令 来 注入 IOptions<T> 类 型 的 一 
个 实例 。 


7.3 ”分 层 架 构 


ASPNET Core 是 一 种 技术 , 但 是 与 其 他 技术 一 样 ,不 应 该 仅仅 为 了 使 用 而 去 使 
用 。 换 句 话说 ， 要 利用 好 一 种 强大 的 技术 ， 最 好 的 方法 就 是 把 这 种 搁 术 放 到 业务 领 
域 的 上 下 文中 。 因 此 ， 对 于 软件 技术 ， 如 果 没 有 合理 有 效 的 架构 ， 很 难 创建 复杂 的 
应 用 程序 。 

在 Visual Studio 中 , 创建 自己 的 控制 器 类 很 容易 。 只 需要 石 击 某 个 项 目 文 件 夹 ， 
然后 添加 一 个 新 类 即 可 ， 甚 至 可 以 添加 一 个 POCO 类 。 在 控制 器 类 内 ， 通 第 每 个 需 
要 控制 器 处 理 的 用 户 操作 都 对 应 一 个 方法 。 如 何 编写 操作 方法 呢 ? 

操作 方法 应 该 收集 输入 数据 ， 并 使 用 输入 数据 准备 一 个 或 多 个 对 应 用 程序 中 间 
层 的 调用 。 然 后 ， 操 作 方 法 收 到 计算 或 者 结果 ， 并 填充 视图 需要 接收 的 一 个 模型 。 
最 后 ， 操 作 方 法 为 用 户 代理 设置 响应 。 这 些 工 作 可 能 需要 若干 行 代 码 完成 ， 使 得 即 
使 只 有 几 个 方法 的 控制 器 类 也 变 得 很 混乱 。 模 型 绑 定 层 基本 上 符 我 们 完成 了 大 部 分 
获取 输入 数据 的 工作 。 最 终 ， 生 成 啊 应 的 操作 只 需要 调用 一 个 方法 来 触发 对 操作 结 
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果 的 处 理 。 操 作 方 法 的 核心 是 执行 任务 并 为 视图 准备 数据 的 代码 。 这 些 代码 应 该 放 
在 什么 位 置 呢 ? 和 直接 放 到 控制 占 关 中 吗 ? 

控制 问 只 是 分 层 结构 中 最 容易 被 映射 到 表示 层 的 顶层 部 分 。 在 表示 层 下 ， 还 有 
其 他 几 个 层 , 它们 共同 构成 了 一 个 简洁 的 应 用 程序 , 很 容易 部 普 到 云 关 及 进行 扩展 。 
对 于 设计 控制 器 及 其 依赖 ，Layered Architecture( 分 层 架 构 ) 模 式 是 一 种 很 有 启发 的 模 
式 (如 图 7-1 所 示 )。 

与 经 典 的 三 层 架 构 相 比 ， 分 层 染 构 包 含 第 4 个 层 ， 并 且 扩 展 了 数据 访问 层 的 概 
仿 ， 使 其 涵 寺 其 他 任何 必要 的 基础 结构 部 分 ， 例 如 数据 访问 和 其 他 许多 跨 领 域 关 注 
点 (如 电子 邮件 、 日 志和 缓存)。 

经 典 的 三 层 染 构 的 业务 层 被 分 解 为 应 用 层 和 领域 层 。 这 是 为 了 表明 存在 册 种 类 
型 的 业务 逻辑 应 用 逻辑 和 领域 逻辑 。 


表示 层 


应 用 层 


领域 技 


基础 结构 层 ~ 
i 
图 7-1 分 层 染 构 的 图 形 化 表示 

e 应 用 逻辑 用 于 协调 表示 层 触发 的 任何 任务 。 在 应 用 层 中 将 执行 所 有 特定 于 
e 领域 逻辑 是 特定 业务 的 任意 可 在 多 个 表示 层 重 用 的 核心 逻辑 。 它 处 理 的 是 业 

务 规 则 和 核心 的 业务 任务 ， 使 用 的 数据 模型 是 严格 面 问 业务 的 。 
在 ASPNET MVC 应 用 程序 中 ， 表 示 层 由 控制 占 构 成 ， 应 用 层 由 控制 占 特 定 的 

服务 类 构成 。 在 文献 中 ， 这 些 服务 被 称 为 应 用 程序 服务 或 者 工作 者 服务 。 


7.3.1 表示 层 
表示 层 将 数据 传递 到 系统 的 其 他 地 方 ， 理 想 情况 下 ， 其 使 用 的 数据 模型 能 够 很 


好 地 反映 屏 硕 中 数据 的 结构 。 一 般 来 说 ， 表 示 层 中 每 个 同系 统 后 端 提交 命令 的 屏 知 
会 把 数据 分 组 到 一 个 输入 模型 中 ， 并 使 用 视图 模型 中 的 类 来 接受 啊 应 。 输 入 模型 和 
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视图 模型 可 能 是 同一 个 模型 。 不 止 如 此 ， 它 们 还 可 能 与 后 问 用 来 执行 实际 任务 的 数 
据 模型 是 同一 个 模型 。 当 一 个 实体 可 用 于 输入 、 风 和 辑 、 持 久 化 和 视图 时 ， 说 明 人 处 理 
的 应 用 程序 特别 向 单 。 当 然 ， 这 也 可 能 说 明 人 大 下 了 很 大 的 技术 俩 。 


1. 输入 模型 
在 ASPNET MVC 中 , 用 户 的 点 击 会 引发 一 个 请 求 ， 该 请求 将 由 控制 右 类 处 理 。 


每 个 请 求 航 转换 为 一 个 操作 ， 了 映射 到 控制 规 兴 上 定义 的 一 个 公有 方法 。 那 么 ， 输 / 
数据 呢 ? 


同样 , 在 ASPNET 中 ,任何 得 入 数据 都 被 封 闻 到 一 个 HITP 请 求 中 ,不管 输 入 
数据 来 自得 询 字 符 串 、 表 单 提 交 的 数据 还 是 HITP 头 或 cookie。 输 入 数据 代表 提交 
给 服务 器 处 理 的 数据 。 无 论 从 哪个 角度 看 ， 它 们 都 只 是 输入 参数 。 可 以 把 输入 数据 
看 成 松散 值 和 变量 ， 也 可 以 把 它们 分 组 到 一 个 用 作 容 器 的 类 中 。 输 入 类 的 集合 构成 
了 应 用 程序 的 总 体 输 入 模型 。 

答 入 模型 在 系统 核心 部 分 传递 数据 的 方式 符合 用 户 界 面 的 预期 。 使 用 一 个 隔离 
的 输入 模型 ， 使 得 以 面向 业务 程度 极 高 的 方式 设计 用 户 界 面 变 得 更 加 价 单 。 然 后 ， 


2. 视图 模型 


任何 请 求 都 会 得 到 响应 ， 而 且 从 ASPNET MVC 得 到 的 响应 大 部 分 时 候 是 一 个 
HTML 视图 。 在 ASPNET MVC 中 ，HTML 视图 的 创建 是 受 控 制 器 控制 的 ， 控 制 器 
调用 系统 的 后 端 并 接收 啊 应 。 然 后 , 控制 器 选择 要 使 用 的 HIML 模板 ,并 将 该 HTML 
模板 和 数据 传递 给 一 个 专门 的 系统 组 件 ， 即 视图 引擎 ， 后 者 将 把 模板 和 数据 混合 起 
来 ， 生 成 供 浏 览 占 使 用 的 标记 。 

如 第 5 革 所 述 ， 在 ASPNET MVC 中 ， 有 有 几 种 方式 可 把 数据 传递 给 视图 引擎， 
从 而 将 数据 包含 到 生成 的 视图 中 。 可 以 使 用 公有 和 字典， 如 ViewData; 可 以 使 用 动态 
对 象 ， 如 ViewBag; 还 可 以 使 用 一 个 定制 的 类 来 收集 所 有 要 传递 的 属性 。 如 果 创 建 
的 任何 类 保存 了 要 添加 到 啊 应 中 的 数据 ， 那 么 就 为 创建 视图 模型 作 了 贡献 。 应 用 层 


[HttpGetl] 
public IActionResult List (CustomerSsearchIinputModel input) 
{ 
Var model = applicationLayer.GetListofCustomers (InPUtL) 7 


return View (model).; 


} 


在 将 来 ， 持 久 化 的 理想 格式 将 与 表示 层 的 理想 格式 不 同 。 表 示 层 负责 定义 可 接 
受 数据 的 明确 边界 ， 应 用 层 负责 只 以 这 些 格式 接受 和 提供 数据 。 
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7.3.2 应 用 层 


应 用 层 是 系统 后 端的 入 口 点 ， 是 表示 层 与 后 端的 接触 点 。 应 用 层 的 方法 以 几乎 
一 对 一 的 方式 绑 定 到 表示 层 的 用 例 。 我 们 建议 为 每 个 控制 器 创建 一 个 服务 类 ， 让 控 
制 器 的 操作 方法 服从 服务 类 。 服 务 类 中 的 方法 将 接受 输入 模型 中 的 类 ， 返 回 视图 模 
型 中 的 类 。 在 内 部 ， 服 务 类 将 执行 合适 的 转换 ， 使 数据 恰当 地 映射 到 表示 层 ， 准 备 
好 供 后 端 处 理 。 

应 用 层 的 主要 目的 是 按照 用 户 的 视角 将 业务 过 程 抽象 出 来 ， 并 将 这 些 过 程 映射 
到 应 用 程序 后 端的 隐藏 的 受 保护 资源 。 例 如 ， 在 电子 商务 系统 中 ， 用 户 会 看 到 购物 
车 , 但 是 物理 数据 模型 可 能 没有 购物 车 这 样 的 实体 。 应 用 层 位 于 表示 层 和 后 端 之 间 ， 
进行 任何 必要 的 转换 。 

当 大 量 使 用 应 用 层 时 ,控制 器 就 成 为 精简 的 控制 器 ， 因为 它们 把 全 部 协调 工作 移 
交 给 了 应 用 层 。 最 后 ， 应 用 层 是 可 以 完整 测试 的 ， 并 且 完 全 不 知道 HTTP 上 下 文 。 


7.3.3 ”领域 层 


领域 层 是 业务 馆 辑 中 一 般 不 随 用 例 变 化 的 部 分 。 用 例 是 用 户 与 系统 之 间 的 交 
互 。 根 据 用 来 访问 网 站 的 设备 或 者 网 站 的 版 本 ， 用 例 有 时 会 有 不同。 领域 逻辑 提供 
的 代码 和 工作 流 是 针对 业务 领域 的 ， 而 不 是 针对 具体 的 应 用 程序 功能 。 

领域 层 由 两 种 类 构成 : 领域 模型 和 领域 服务 。 领 域 模型 中 的 类 表达 业务 规则 和 
领域 过 程 。 不 应 该 试图 在 这 里 识别 要 持久 化 的 数据 聚集 相反， 识别 出 的 任何 聚集 
应 该 来 日 对 业务 的 理解 和 建 模 。 如 图 7-2 所 示 ， 领 域 层 的 类 是 与 持久 化 无 关 的 。 使 
用 领域 模型 类 只 是 为 了 以 便于 编码 的 方式 来 执行 业务 任务 。 


初始 状态 


领域 模型 


最 终 状 态 


图 7-2 领域 模型 中 的 类 从 外 部 接收 状态 


状态 被 注入 领域 模型 类 中 。 例 如， 领域 模型 的 Invoice 类 知道 如 何 处 理发 案 , 但 
是 它 需 要 从 外 部 接收 要 处 理 的 数据 .领域 模型 与 持久 化 层 之 加 的 连接 点 是 领域 服务 。 
领域 服务 是 一 个 类 ， 位 于 数据 访问 的 上 方 ， 负 员 取 得 数据 ， 把 状态 加 载 到 领域 模型 
类 ， 然 后 从 领域 模型 大 中 取出 修改 后 的 状态 并 放 回 数据 访问 层 。 

存储 库 是 最 向 单 和 最 才 名 的 领域 服务 示例 。 领 域 服务 类 通 利 会 引用 数据 访问 层 。 
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/重要 / 

上 面 介 绍 的 领域 模型 的 思想 类 似 于 领域 驱动 设计 (DDD) 中 的 领域 模型 的 思想 。 
但 是 ， 从 实用 的 角度 来 讲 ， 领 域 模型 的 意义 在 于 业务 逻辑 和 行为 。 有 了 时， 通过 类 来 
建 模 业 务 规则 可 以 简化 设计 。 领 域 模型 的 附加 价值 是 这 种 设计 上 的 简化 ， 而 不 是 让 
你 可 以 在 解决 方案 上 附 上 “我 采用 了 DDD” 的 标签 。 因 此 ， 并 不 是 所 有 的 应 用 程序 
都 真 的 需要 使 用 领域 模型 . 


7.3.4 基础 结构 层 


基础 结构 层 与 使 用 具体 的 技术 相关 ， 这 些 技术 可 以 是 数据 持久 化 (OARM 框架 ， 
如 Entity Framework)、 外 部 Web 服务 、 特 定 的 安全 API、 日 忘记 录 、 跟 踪 、IoC 容 
介 、 电 子 邮 件 、 组 人 存 等 。 

持久 化 层 是 基础 结构 层 中 最 突出 的 组 件 ， 它 束 是 原来 的 数据 访问 层 ， 只 不 过 得 
到 了 扩展 ， 在 普通 关系 数据 存储 之 外 还 包含 了 其 他 几 个 数据 源 。 持 久 化 层 由 存储 库 
类 构成 ， 知 道 如 何 读 取 和 /或 保存 数据 。 

在 概念 上 ， 存 储 库 类 只 在 持久 化 实体 (如 Entity Framework 实体 ) 上 执行 CRUD 
操作 。 但 是 ， 可 以 在 存储 库 中 添加 任意 级 别 的 多 辑 。 在 其 中 添加 的 逻辑 越 多 ， 扎 看 起 
来 束 越 像 一 个 领域 服务 或 者 一 个 应 用 程序 服务 ， 而 不 是 一 个 普通 的 数据 访问 工具 。 

轧 之 ， 分 层 染 构 的 总 义 在 于 建立 一 个 依赖 链 ， 从 探 制 占 开始 ， 经 过 应 用 程序 服 
务 并 使 用 领域 模型 类 (如 果 有 )， 最 后 到 达 后 端 搬 部 。 


7.4 ”处理 异常 


在 ASPNET Core 中 ， 会 发 现 经 典 ASPNET MVC 中 的 许多 异常 处 理 功 能 ， 但 
是 找 不 到 与 web.config 文件 相关 的 功能 ， 如 目 动 重 定 问 到 错误 页 面 。 尽 管 如 此 ， 
ASPNET Core 中 的 异常 处 理 实践 与 经 典 ASPNET 多 多 少 少 是 相同 的 。 

ASPNET Core 提供 了 弄 第 处 理 中 间 件 和 基于 控制 器 的 异 钊 角 选 占 。 


7.4.1 异 钊 处 理 中 国 件 


ASPNET Core 中 的 异常 处 理 中 间 件 提供 了 一 个 集中 的 错误 处 理 程序 , 其 在 概念 
上 相当 于 经 典 ASPNET 中 的 Application Error 处 理 程 序 。 此 中 间 件 捕捉 任意 未 处 理 
的 异 第 ， 并 使 用 目 定 义 的 丈 辑 将 请 求 路 由 到 最 合适 的 铺 误 页 面 。 

中 辐 件 有 了 两 种 ， 针 对 两 类 不 同 的 受众 定制 : 开 及 人 员 和 用 户 。 合 理 的 做 法 是 ， 
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在 生产 (甚至 暂 存 ) 环 谋 中 使 用 用 户 的 页 面 ， 而 在 开发 中 使 用 开 肥 人 员 的 页 面 。 
1. 生产 中 的 错误 处 理 


无 论 选择 哪 种 中 间 件 ， 配 置 方 法 都 是 相同 的 : 使 用 局 动 类 的 Configure 方法 将 
中 间 件 添加 到 管道 中 。 


public class Startup 


{ 
public void Configure (IApplicationBuilder app) 
{ 
app.UseExceptionHandler ("/apPp/Aerror'" ) ; 
app.UseMyvc () ; 
} 
} 


UseExceptionHandler 扩展 方法 接受 一 个 URL， 并 在 ASPNET 管道 中 添加 一 个 
对 该 URL 的 新 请 求 。 到 指定 钳 误 页 面 的 路 由 并 不 是 一 个 规 艺 的 HITP 302 重 定 问 ， 
而 更 像 是 有 一 个 内 部 的 优先 请 求 ， 官 道 则 照常 处 理 该 请 求 。 

从 开发 人 员 的 角度 看 ， 是 将 用 户 “ 路 由 ”到 一 个 页 面 ， 该 页 面 可 以 确定 什么 错 
误 消 有 息 最 为 合适 。 在 茶 种 程度 上 ， 铬 误 处 理 与 应 用 程序 的 主 远 和 辑 解 奈 了 。 但 是 ， 与 
此 同时 ， 铬 误 请 求 的 内 部 本 性 使 得 处 理 铬 误 的 代码 能 够 完全 访问 检测 到 的 异 第 的 全 
部 细节 。 注 意 ， 在 经 典 的 重 定 向 中 ， 除 非 显 式 地 将 异常 信息 传递 给 HITP 320 啊 应 
之 后 的 “下 一 个 ”请 求 ， 人 否则 异 单 信息 将 会 丢失 。 


注意 : 
应 该 把 异 第 处 理 中 间 件 放 到 管道 的 最 顶端 ， 以 确保 能 够 检测 到 应 用 程序 没有 捕 
捉 的 所 有 可 能 发 生 的 异 第 。 


2. 获取 异常 细节 


正确 配置 了 异常 处 理 中 间 件 之 后 ， 任 何 未 处 理 的 异常 都 会 把 应 用 程序 流 路 由 到 
一 个 公共 闯 点 。 在 上 面 的 代码 段 中 ， 这 个 闯 点 就 是 AppController 类 的 Error 方法 。 
下 和 面 给 出 了 该 方法 的 最 基本 实现 ， 其 中 最 重要 的 部 分 是 如 何 获取 开 稍 信息 。 

public IActionResult Error() 

{ 

// Retrieve error information 
Var error = HttpContext.Features.Get<IExceptionHandlerFeature> (); 
if (error == nullj]) 

return View (model).; 
// Use the information stored in the detected exception object 
var exception = error.Error; 


1 
不 同 于 经 典 ASPNET， 在 ASPNET Core 中 ， 不 存在 内 部 的 Server 对 象 及 其 很 
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受 欢 迎 的 GetLastError 方法 .HTITP 上 下 文 的 Features 对 象 是 获取 未 清除 的 异常 信息 
的 官方 工具 .a 


3. 捕捉 状态 码 


到 目前 为 止 展 示 的 代码 足以 捕捉 和 处理 代 人 码 执 行 过 程 中 产生 的 任何 内 部 服务 器 
错误 (HTTP 500)。 但 是 ， 如 果 是 其 他 状态 码 ， 应 该 怎么 办 ? 例如 ， 如 果 由 于 URL 不 
存在 而 产生 一 个 异常 ， 应 该 怎么 办 ? 为 了 处 理 没 有 匹配 到 HITP 500 的 异 弟 ， 需 要 
添加 另 一 个 中 间 件 。 


app.UsestatusCodePagesWithReExecute ("/app/error/{0}"); 


如 果 检 测 到 非 HTTP 500 异 弟 ,UseStatusCodePageWithReExecute 扩展 方法 会 把 
应 用 程序 流 路 由 到 指定 URL。 考虑 到 这 一 点, 应 该 对 上 面 的 错误 处 理 代 人 码 稍 作 修 改 。 
public IRctionResult Error( 
[Bind (Prefix = "id")] int statusCode = 0) 
// Switch to the appropriate page 


switch(statusCode) 
| 


CaSe 404: 
return Redirect(...); 


} 


// Retrieve error information in case of internal errors 
Var error = HttpContext.Features.cGcet<IExceptijonHandlerFeature> ();}; 
if (error == null]l) 

return View (model).; 


// Use the information stored in the detected exception object 
Var exception = error.Error; 


I 

当 发 生 其 他 铬 误 时 ， 例 如 HITP 404 铅 误 ， 需 要 由 你 来 决定 重 定 癌 到 一 个 静态 
山 面 或 祝 网 ， 或 者 只 是 调整 Error 方法 提供 的 同一 个 视 疼 中 的 销 误 消 息 。 

4. 开发 中 的 错误 处 理 

ASPNET Core 的 模块 化 程度 极 局 ， 需 要 使 用 的 几乎 每 个 功能 都 必须 被 显 式 局 
用 。 甚 至 对 于 调试 错误 页 面 (经 典 ASPNET 开发 人 员 习 惯 把 它们 称 为 “黄色 死亡 页 
面 ”) 也 是 如 此 。 为 了 能 够 在 发 生 开 第 时 看 到 实际 的 消息 和 堆栈 跟 踩 ， 还 需要 使 用 另 
一 个 中 间 件 。 


app.UseDeveloperExceptionPage (); 


这 个 中 间 件 不 允许 路 由 到 任何 目 定 义 页 面 ; 它 只 是 动态 准备 一 个 系统 错误 页 [ 
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提供 了 发 生 开 向 时 系统 状态 的 一 个 快照 ， 如 图 7-3 所 示 。 


‘SS (| http//ocalhost61793/ 
辣 Internal Server Error x ] UJ € 


An unhandled exception occurred while processing the request. 


ArgumentException: Deliberate exception 


simple.AllMyControllersHere.Home.Index0 in Home .cs, line 20 
FE Query Cookies Headers 


ArgumentException: Deliberate exception 


simple.AllMyControllersHere.Home.Index() in Home .cs 
28. throw new ArgumentException{("Deliberate exception™”); 


lambda_method{Closure , object , Object[] ) 

Microsoft.AspNetCore.Myvc.Internal.ControllerActionInvoker+ <InvokeActionMethodAsync>d_ 27.MoveNext() 
system.RUntime.EXceptionservices.ExceptionDispatchlnfc.Throw0 

System.Runtime.CompilerServices. TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task) 
Microsoft.AspNetCore.Myvc.Internal.ControllerActionInvoker+ <InvokeNextActionFilterAsync>d_25.MoveNext() 
System.RuNtime.ExceptionServices.ExceptionDispatchiInfo. Throw0 
Microsoft.AspNetCore.Mvyc.Internal.ControllerActionlnvoker.Rethrow(ActionEXxecutedContext context) 


Microsoft.AspNetCore.Myvc.Internal.ControllerActionInvoker.Next(ref State next, ref Scope scope, ref object state, ref bool| 
isCompleted) 


和 
i 二 二 1s Eri [i 二 1 一 本 rr TL 三 本 "| 人 md Ls 


图 7-3 ”开发 人 员 的 异 第 页 面 


多 数 时 候 ， 我 们 会 布 望 目 动 切换 生产 环境 和 开 妈 环境 的 开 币 处 理 中 间 件 。 如 果 
使 用 了 牡 主 环境 API 的 服务 ， 这 很 容易 实现 。 


Public void Configure (IApplicationBuilder app，IHostlIngEnVvITOnment env) 


{ 
if (env.IsDevelopment()) 
{ 
app.UseDeveloperExceptionPage () 7 
app.UseSstatusCodePagesWithReExecute("/app/error/{0}"); 
} 
else 
{ 
app.UseExceptionHandler ("~/app/error"™"); 
app.UsesSstatusCodePagesWithReExecute("/app/error/{0}"); 
} 
} 


使 用 IHostingEnvironment 方法 可 检 训 当前 的 环境 ,并 智能 地 决定 局 用 哪个 异 章 
中 间 件 。 


7.4.2 ”异常 筛选 器 
作为 规范 开发 的 一 个 一 般 准则 , 应 该 把 任何 有 可 能 引发 异常 的 代码 (如 远程 Web 


171 


第 川 部 分 ”路 领域 关注 点 


服务 或 数据 库 调用 ) 放 到 trycatch 块 中 。 另 外 ,还 可 以 对 控制 器 代码 使 用 异常 俑 选 器 。 
1. 设置 异 浊 径 选 器 


从 技术 上 讲 ， 卉 第 筛选 器 就 是 一 个 实现 了 IExceptionFilter 接口 的 类 的 实例 ， 该 
接口 的 定义 如 下 。 

public interface IExceptionFilter : IFilterMetadata 

{ 


VODO1Q OnException (ExceptionContext ConteXt) ， 


} 


沛 选 般 在 ExceptionFilterAttribute 及 其 所 有 派生 类 中 实现 , 包括 控制 融 尖 。 这 总 
味 痢 可 以 重 写 任何 控制 器 的 OnException 方法 , 将 其 作为 一 个 普 裔 适用 的 处 理 程序 ， 
处 理 在 执行 控制 上 融 操作 时 友 生 的 任何 寞 第 ， 或 者 在 执行 控制 右 或 操作 方法 关联 的 为 
一 个 肾 选 右 时 发 生 的 任何 卉 第。 

可 以 配置 开 帝 关 选 邢 ， 使 其 全 局 运行 一 一 在 每 个 控制 项 上 运行 ， 其 全 在 每 个 操 
作 上 运行 。 开 和 并 选 右 个 会 锌 调用 来 处 理 控制 茵 操作 外 发 生 的 开 向 。 


下 站 


异常 利 选 器 不 能 捕捉 模型 绑 定 异常 、 路 由 异常 ， 以 及 生成 的 状态 码 不 是 HTTP 
500 的 异常 。 对 于 最 后 这 种 异常 ， 生 成 的 状态 码 最 多 的 是 HTTP 404， 但 是 也 有 授权 
异常 ， 如 HTITP 401 和 HTTP 403， 


2. 处 理 启动 异常 


到 目前 为 止 讨 论 的 所 有 天 稼 处理 机 制 都 在 应 用 程序 党 道 的 上 下 文中 运行 。 然 而 ， 
在 应 用 程序 启动 后 ， 管 道 还 没有 被 完整 配置 好 的 时 候 ， 也 有 可 能 发 生 异 常 。 为 了 捕 
提 局 动 寞 弟 ， 必 须 在 Program.cs 中 调整 WebHostBuilder 类 的 配置 。 

除了 前 和 面 章节 中 讨论 的 所 有 设置 ， 还 可 以 添加 一 个 CaptureStartupErrors 议和 首 ， 
如 下 所 示 。 

var host = new WebHostBuilder () 


-CaptureStartupErrors (true) 
-BUILT dl) ， 


默认 情况 下 ， 当 局 动 过 程 由 于 发 生 错 误 而 突然 终止 时 , 箱 主 会 悄悄 退出 。 不 过 ， 
当 把 CaptureStartupErrors 议 阐 为 true 时 ， 牡 主将 捕 换 局 劲 闪 引 及 的 任何 卉 再 ， 并 才 
试 显示 一 个 错误 页 面 。 这 个 页 面 可 能 是 通用 的 或 者 非常 详细 ， 具 体 显 示 哪 种 页 面 要 
取决 于 WebHostBuilder 类 中 添加 的 另 一 个 设置 的 值 。 


Var host = new WebHostBRBuilder{() 
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-CaptureSstartupErrors (true) 
-UseSetting(" "detailedErrors", "true"™) 
- Build(); 


当局 用 了 detailedErrors 设置 时 ， 显 示 的 错误 页 面 将 采用 与 图 7-3 相同 的 模板 。 
7.4.3 ”记录 异常 


在 ASPNET Core 中 ， 通 过 UseExceptionHandler 中 间 件 处 理 的 异常 将 被 目 动 记 
he 当然 这 要 求 系统 中 yw 了 一 个 记录 天 组 件 。 所 有 记录 器 实例 通过 系统 
提供 的 记录 吉 工 厂 传 递 ， 这 是 默认 添加 到 DI 系统 中 的 少数 服务 之 一 。 


1. 链接 日 志 记 录 提 供 程 序 


ASPNET Core Logging API 构建 在 特殊 的 组 件 之 上 ， 这 些 组 件 称 为 日 忘记 录 提 
共 程 序 。 日 志 记 录 提 供 程 序 允 许 将 日 志 发 送 给 一 个 或 多 个 目标 ， 如 控制 台 、Debug 
窗口 、 文 本 文件 、 数 据 库 等 。ASPNET Core 提供 了 多 种 内 置 的 提供 程序 ， 也 人 允许 添 
加 目 定 义 提供 程序 。 
要 将 日 志 记 录 提 供 程 序 链接 到 系统 ， 一 种 第 用 的 方法 是 使 用 ILoggerFactory 版 
务 的 扩展 方法 。 
public void Configure (IApplicationBuilder app, ILoggerFactory loggerFactory) 


{ 
// Register two different logging providers 


loggerFactory.AddConsole (); 
loggerFactory .AddDebug () ; 
} 


在 同一 个 应 用 程序 中 ， 可 以 有 任意 多 的 日 志 记录 提供 程序 。 添 加 日 志 记录 提供 
程序 时 ， 还 可 以 选择 添加 一 个 日 志 级 别 ， 此 时 提供 程序 将 只 接受 具有 合适 的 相关 性 
级 别 的 消息 。 


2. 创建 日 志 


日 志 记 录 提 供 程序 的 工作 方式 是 把 消息 存储 到 各 目的 目标 中 。 以 某 种 方式 (如 按 
是 名 称 ) 只 别 的 相关 消 奶 的 集合 就 构成 了 一 个 日 志 。 代 码 通 过 ILogger 接口 的 服务 写 
入 日 忘 。 可 通过 两 种 不 同 的 方式 来 创建 记录 肯 。 
首先 , 可 以 从 工厂 直接 创建 记录 器。 下 和 耐 的 代码 段 显示 了 如 何 创 建 一 个 记录 器 ， 
并 为 其 起 一 个 独特 的 名 称 。 通 常 ， 记 录 器 在 控制 占 的 作用 域内 进行 日 志 记 录 。 


public class CustomerController : Controller 


{ 
ILogger logger; 
Public CustomerCcontroller{(ILoggerFactory loggerFactory) 
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{ 
logger = loggerFactory.CreateLogger("Customer Controller™); 
logger.LoglInformation("Some message here”™); 
} 
} 


CreateLogger 方法 获取 日 忘 的 名 称 ， 并 在 注册 的 提供 程序 中 创建 该 日 忘 。 
LogInformation 方法 只 是 允许 写 入 日 六 的 众多 方法 之 一 。ILogger 接口 为 文 持 的 每 个 
日 忘 级 别提 供 了 一 个 日 忘记 录 方 法 ， 例 如 为 了 消除 厂 段 ，LogInformation 用 于 输出 
信息 类 消息 ,LogWarning 则 用 于 更 加 严重 的 警告 消息 。 日 志 记录 方法 可 以 接受 普通 
字符 串 、 格 式 化 字符 串 甚至 异常 对 象 进行 序列 化 。 

另外 ， 也 可 以 通过 DI 系统 来 解析 ILogger<T> 依 赖 ， 从 而 绕 过 记录 器 工厂 。 

public class CustomerController : Controller 


{ 
lILogger Loggers: 


Public CustomercCcontroller (ILogger<CustomerController> logger) 
L 

Logger = logger; 
} 


// Use the internal member in the action methods 


} 


这 里 创建 的 日 忘 使 用 控制 占 类 的 完整 名 称 作 为 前 级 。 


7.5 本 


为 编号 ASPNET Core 应 用 程序 ， 必 须 熟 悉 访 框架 的 DI 系统 。 这 是 一 个 关键 的 
变化 ， 它 使 我 们 更 深入 地 思索 接 口 与 具体 类 型 。 针 对 接口 而 不 是 实现 进行 编程 是 一 
个 古老 的 建议 ， 但 是 如 今 依然 有 效 。 接 口 在 ASPNET Core 中 无 处 不 在 ， 它 们 提供 
了 一 种 方法 来 让 开发 人 员 用 目 定 义 功 能 代 蔡 默认 的 功能 。 我 们 给 出 的 第 一 个 使 用 接 
口传 递 数据 的 例子 是 传递 配置 数据 。 男 外 一 个 更 加 重要 的 示例 是 应 用 程序 代码 的 分 
层 结 构 ， 这 种 结构 可 堆积 控制 右 、 应 用 程序 服务 、 存 储 库 以 及 (可 选 的 ) 领 域 模型 类 。 

过 去 的 ASPNET 中 的 最 佳 实践 主要 靠 各 个 团队 和 开发 人 员 的 目 律 ， 如 今 这 在 
ASPNET Core 中 己 被 提升 到 常规 做 法 的 地 位 。ASPNET Core 的 设计 决定 了 其 得 到 
的 代码 的 质量 要 比 ASPNET 框架 的 任何 版 本 都 更 好 。 大 部 分 弟 用 的 最 佳 实 践 已 被 设 
计 到 ASPNET Core 中 。 

第 8 章 在 讨论 如 何 使 用 API 来 保护 对 应 用 程序 的 访问 时 ,将 给 出 另外 一 个 把 最 
佳 实践 直接 纳入 框架 的 例子 。 
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应 用 程序 安全 


没有 变化 和 不 需要 变化 的 地 方 不 会 有 智慧 。 
一 一 赤 伯 特 。 乔 治 ， 威 尔 斯 ,《 时 间 机 器 》 


Web 应 用 程序 的 安全 包 合 许多 方面 。 首 先 也 是 最 重要 的 ， 在 Web 场景 中 ， 安 全 
涉及 确保 交换 的 数据 的 机 密 性 。 其 次 ， 安 全 涉 友 避免 数据 被 繁 改 ， 从 而 确保 从 一 十 
传送 到 为 一 六 时 的 信息 的 完整 性 。Web 安全 的 为 一 个 方面 是 防止 恶意 代 公 被 注入 运 
行 中 的 应 用 程序 。 最 后 ， 安 全 涉及 构建 只 有 经 过 吴 份 验证 和 授权 的 用 户 才 能 访问 的 
应 用 程序 (和 应 用 程序 部 分 )。 

本 章 将 介绍 在 ASPNET Core 中 如 何 实现 用 户 喘 份 验证 ， 以 及 如 何 使 用 新 的 基 
于 素 略 的 API 来 处 理 用 户 授权 。 不 过 ， 在 那 乙 前 ， 需 要 先 了 解 安 全 基础 结构 。 


8.1 Web 安全 基础 结构 


HTTP 协议 在 设计 时 并 没有 考虑 安全 性 ， 但 是 后 来 加 上 了 安全 性 。HTTP 是 不 
加 密 的 ， 这 意味 看 第 三 方 能 够 截获 两 个 彼此 连接 的 系统 之 间 传 递 的 数据 。 


8.1.1 HTTPS 协议 


HTTPS 是 HTTP 协议 的 安全 版 。 在 网 站 上 使 用 HTTPS 以 后 ， 浏 览 器 与 网 站 之 
间 的 所 有 通信 都 会 被 加 密 。 进 入 和 离开 HTTPS 页 面 的 任何 信息 也 会 被 自动 加 密 ， 
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以 确保 完全 保密 。 加 密 基 于 安全 证 书 的 内 容 。 数 据 的 发 送 方式 取决 于 Web 服务 器 上 
启用 的 安全 协议 , 例如 传输 层 安全 性 (Transport Layer Security，TLS) 及 其 前 身 一 一 安 
全 短 接 宁 层 (Secure Socket Layer，SSL)。 

SSL 是 第 一 个 开发 出 的 安全 传输 协议 ， 是 1995 年 由 Netscape 开发 的 。 一 年 之 
后 ， 它 就 发 展 到 了 3.0 版 本 ， 但 是 1996 年 以 后 就 没有 再 更 新 。 显 然 ，SSL 是 开发 安 
全 协议 的 一 次 不 完善 的 答 试 。1999 年 , TLS 1.0 发 布 , 它 补 设计 为 与 SSL 3.0 不 兼容 ， 
以 强制 人 们 放弃 SSL， 改 为 使 用 TLS。2015 年 ，SSL 2.0 和 SSL 3.0 都 被 弃 用 了 。 如 
今 ,都 强烈 建议 在 目 己 的 Web 服务 器 配置 中 茜 用 SSL 2.0 和 SSL 3.0, 而 只 启用 TLS 1.x。 


8.1.2 ”处 理 安全 证 书 


很 多 时 候 ， 在 讨论 HTTPS 和 证 书 时 ， 会 使 用 SSL 证 书 这 种 表达 方式 。 这 似乎 
膏 明 ， 证 书 与 安全 协议 在 某 种 程度 上 是 相关 的 。 但 是 ， 准 确 来 说 ， 证 书 和 协议 是 不 
同 的 。 因 此 ， 将 SSL 证 书 与 TLS 证 书 作 比较 时 无 意义 。 

HTTPS Web 服务 上 的 配置 决定 了 使 用 的 安全 协议 ， 而 证 书 只 包含 一 个 私有 / 公 
共 密 钥 对 ， 并 将 域名 与 所 有 者 号 份 绑 定 在 一 起 。 

对 于 最 终 用 户 ，HTTPS 的 主要 优势 在 于 ， 当 访问 HITPS 网 站 (例如 一 个 银行 网 
站 ) 的 页 面 时 , 可 以 确信 上 自称 是 银行 网 站 的 这 个 网 站 确实 是 一 个 银行 网 站 。 换 句 话 说， 
我 们 答 看 和 区 互 的 页 面 确实 是 其 目 称 的 页 面 。 也 许 你 很 难 相 信 ， 但 是 对 于 非 HITPS 
页 面 来 说 ， 情 况 可 能 并 非 如 此 。 事 实 上 ， 当 没有 使 用 HITPS 时 ， 实 际 的 URL 有 可 
能 是 虚假 或 者 恶意 的 ， 而 交互 的 页 面 可 能 只 是 看 起 来 是 真实 的 页 面 。 因 此 ， 登 录 页 
面 应 该 始终 放 在 HITPS 网 站 上 ， 而 作为 一 名 用 户 ， 在 从 一 个 非 HTTPS 登录 页 面 登 
录 网 站 时 ， 应 该 总 是 保持 谨慎 。 


8.1.3 对 HTTPS 应 用 加 密 
当 浏 览 器 在 一 个 HTTPS 连接 上 请 求 Web 页 面 时 ， 网 站 首先 会 返回 配置 好 的 
HTTPS 证 书 。 证 书 中 包含 建立 安全 对 话 所 需 的 公 铀 。 


接 下 来 , 浏览 磺 和 网 站 将 按照 配置 好 的 协议 ( 通 利 是 TLS) 的 规则 完成 一 次 握手 。 
如 果 浏 览 器 信任 证 书 ， 惑 会 生成 一 个 对 称 的 公 钥 / 私 钥 ， 并 与 服务 器 分 享 公 铀 。 


8.2 ASP.NET Core 中 的 身份 验证 


与 老 版 本 的 ASPNET 相 比 ， 用 户 身 份 验证 是 ASPNET Core 中 变化 最 大 的 地 方 
之 一 。 不 过 ， 总 体 的 身份 验证 方法 依然 基于 熟悉 的 概念 ， 例 如 主体 、 登 录 表 单 以 及 
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质询 和 授权 特性 ; 但是， 它们 的 实现 方式 变化 很 大 。 接 下 来 探讨 ASPNET Core 中 
提供 的 cookie 有 身份 验证 API， 包 括 外 部 身份 验证 的 核心 信息 。 


8.2.1 基于 cookie 的 身份 验证 


在 ASPNET Core 中 ， 用 户 映 份 验证 的 方式 是 使 用 cookie 来 跟踪 用 户 的 里 份 。 
任何 试图 访问 私有 页 和 面 的 用 户 都 将 被 午 定 问 到 一 个 登录 页 面 ， 除 非 他 们 具有 有 效 的 
有 身份 验证 cookie。 然 后 ， 登 录 幢 面 在 客户 端 收集 和 凭据， 并 在 服务 器 问 验 证 这 些 任 据 。 
如 果 验 证 通过 ,将 发 出 一 个 cookie。 该 用户 从 同一 个 浏览 器 发 出 的 所 有 后 续 请 求 都 将 
带 有 该 cookie， 直 到 其 过 期 。 这 个 工作 流 与 老 版 本 的 ASPNET 并 没有 什么 区 别 。 

对 于 具有 ASPNET Web Forms 和 ASPNET MVC 背景 的 开发 人 员 来 说 ， 在 
ASPNET Core 中 有 两 个 大 变化 。 

e 首先 , 不 再 有 一 个 web.config 文件 ， 这 意味 看 需要 采用 不 同 的 方式 指定 和 获 

取 登 录 路 径 、cookie 名 称 和 过 期 配置 。 
e 其 次 ，IPrincipal 对 象 ( 即 用 于 建 梗 用 户 喘 份 的 对 象 ) 是 基于 声明 的 ， 而 不 是 完 
全 基于 用 户 名 。 


1. 局 用 身份 验证 中 间 件 


要 在 一 个 全 新 的 ASPNET Core 应 用 程序 中 局 用 cookie 号 份 验证 ， 需 要 引用 
Microsoft.AspNetCore.Authentication.Cookies 包 。 但 是 ， 在 ASPNET Core 2.0 中 ， 输 
入 应 用 程序 中 的 实际 代码 与 以 前 版 本 的 ASPNET Core 框 染 不 同 。 

导 份 验证 中 间 件 是 作为 服务 公开 的 ， 因 此 必须 在 局 动 类 的 ConfigureServices 方 
法 中 进行 配置 。 


Public void ConfigureServices (IServiceCollection services) 
{ 
Services.AddAuthentication (CookieAuthenticationDefaults.AuthenticationSscheme) 
.AddCookie (options 三 > 
{ 
options.LoginPath = new PathSstring("/Account/Login™); 
options.Cookie.Name = "YourAppCookieName"} 
options .ExpireTimeSpan = TimesSpan.FromMinutes (60);} 
options.SlidingExpiration = true; 
options.AccessDeniedPath = new Pathstring("/Account/Denied"); 


1 | 
} 
AddAuthentication 扩展 方法 接受 一 个 字符 串 作 为 参数 ， 该 字符 串 指定 了 要 使 用 
的 身份 验证 方案 。 如 果 计 划 文 持 一 个 身份 验证 方案 ， 就 采用 这 种 方法 。 后 面 ， 我 们 
将 了 解 如 何 对 这 段 代 但 稍 作 调 整 ， 以 文 持 多 个 方案 和 处 理 程 序 。AddAuthentication 
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返回 的 对 象 必须 用 来 调用 男 外 一 个 代表 遇 份 验证 处 理 程 序 的 方法 .在 上 和 面 的 示例 中 ， 
AddCookie 方法 告诉 框架 通过 配置 好 的 cookie 让 用 户 登 录 并 验证 其 身份 。 每 个 身份 
验证 处 理 程序 (cookie、 持 有 者 等 ) 都 有 其 目 己 的 一 组 配置 属性 。 

在 Configure 方法 中 ， 只 是 声明 目 己 想 要 按照 配置 使 用 号 份 验证 服务 ， 而 不 需 
要 指定 其 他 任何 选项 。 

public void Configure (IApplicationBuilder app) 


{ 
app-.-UseAuthentication (); 


} 


在 上 和 面 的 代码 中 ， 有 一 些 名 词 和 概念 需要 作 进 一 步 解释 ， 其 中 最 竺 要 的 束 古 员 
份 验 证 方案 。 


2. cookie 身份 验证 选项 

经 典 ASPNET MVC 应 用 程序 在 web.config 文件 的 <authentication> 节 中 存储 的 
大 部 分 信息 如 今 作 为 中 间 件 选项 在 代码 中 配置 。 上 面 的 代码 段 列 出 了 可 能 用 到 的 一 
些 最 常用 的 选项 。 表 8-1 更 详细 地 介绍 了 每 个 选项 。 


表 8-1 cookie 身份 验证 选项 
选项 描述 
AccessDenledPath 指定 一 个 路 径 ， 如 末 通 过 吴 份 验证 的 用 户 的 当前 号 份 没 有 权限 访问 请 
求 的 资源 ， 就 将 该 用 户 重 定 向 到 指定 的 路 径 。 此 选项 设置 用 户 必须 被 
重 定 问 到 的 URL， 而 不 是 收 到 一 个 普通 的 HITP 403 状态 但 


Cookie CookieBuilder 关 型 的 容 散 对 象 ， 包 舍 创 建 的 身份 验 证 cookie 的 属性 

ExpireTimeSpan 设置 身份 验证 cookie 的 过 期 时 间 。SlidingExpiration 属性 的 值 决定 了 这 
个 时 间 是 绝对 时 间 还 是 相对 时 间 

LogmpPath 指定 一 个 路 径 ， 诬 名 用 户 将 被 重 定 问 到 这 个 路 径 ， 以 使 用 其 凭据 登录 


ReturnUrlParameter 当 划 名 用 户 请 求 URL 时 ， 将 被 重 定 癌 到 登录 页 面 ， 此 选项 指定 了 用 于 
传递 原来 请 求 的 URL 的 参数 名 称 

SlidingExpiration 指定 ExpireTimeSpan 值 代表 绝对 时 间 还 是 相对 时 间 。 如 果 代 表 相 对 时 
间 ， 则 认为 该 值 是 一 个 时 间 区 间 ， 当 该 时 间 区 间 的 一 半 己 经 过 去 时 ， 
中 间 件 将 重 发 cookie 


注意 ， 路 径 属性 (如 LoginPath 和 AccessDeniedPath) 的 值 不 是 字符 串 。 事 实 上 ， 
LoginPath 和 AccessDeniedPath 的 类 型 是 PathString。 在 .NET Core 中 ，PathString 类 
型 与 普通 的 String 类 型 不 同 ,， 因为 它 在 构建 请 求 URL 时 提供 了 正确 的 转 义 。 从 根本 


上 说 ，PathString 类 型 是 更 加 向 向 URL 的 字符 串 类 型 。 
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ASPNET Core 中 的 用 户 身 份 验证 工作 流 的 整体 设计 提供 了 前 所 未 有 的 灵活 性 。 
此 工作 流 的 每 个 方面 均 可 自 定 义 。 作 为 一 个 示例 ， 我 们 将 讨论 如 何 基 于 每 个 请 求 控 
制 身份 验证 工作 流 。 


8.2.2 ”处 理 多 个 身份 验证 方案 


在 以 前 版 本 的 ASPNET 中 , 身份 验证 质询 是 目 动 进行 的 ,我 们 几乎 无 法 控制 这 
个 过 程 。 目 动 号 份 验证 质询 意味 看 当 系 统 检测 到 当前 用 户 缺 少 合适 的 身份 信息 时 ， 
将 自动 显示 配置 好 的 登录 页 面 。 在 ASPNET Core 1.x 中 ， 身 份 验证 质询 在 默认 情况 
下 是 目 动 进行 的 ， 但 是 开发 人 员 可 以 修改 此 行为 。 在 ASPNET Core 2.0 中 ， 再 次 弃 
用 了 关闭 目 动 质询 的 设置 。 

但 是 ， 在 ASPNET Core 中 ， 可 以 注册 多 个 不 同 的 吴 份 验证 处 理 程 序 ， 并 通过 
算法 或 者 通过 配置 来 决定 为 每 个 请 求 使 用 哪个 处 理 程序 。 


1. 局 用 多 个 身份 验证 处 理 程序 


在 ASPNET Core 中 ， 可 以 从 多 个 身份 验证 处 理 程序 中 进行 选择 ， 例 如 基于 
cookie 的 身份 验证 、 持 有 者 有 身份 验证 、 通 过 社交 了 网络 或 者 身份 服务 堪 进 行 刁 份 验 证 ， 
以 及 可 以 想到 并 实现 的 其 他 任何 身份 验证 。 要 注册 多 个 身份 验证 处 理 程 序 ， 只 需要 
在 ASPNET Core 2.0 启动 类 的 ConfigureServices 方法 中 逐一 列 出 各 个 处 理 程序 。 

配置 的 每 个 喘 份 验证 处 理 程序 都 通过 其 名 称 识别 。 名 称 只 是 我 们 随意 决定 的 一 
个 传统 字符 串 ， 用 来 在 应 用 程序 中 引用 该 处 理 程序 。 处 理 程 序 的 名 称 被 称 为 号 份 验 
证 方案 。 可 以 将 身份 验证 方案 指定 为 一 个 故 约 字符 串 ， 如 Cookies 或 Bearer。 但 是 ， 
第 见 的 情况 是 ， 在 代码 中 会 使 用 一 些 预定 义 的 常量 来 减少 错误 的 拼写 。 如 果 使 用 魔 
幻 字符 串 ， 那 么 需要 注意 字符 串 是 区 分 大 小 写 的 。 

// Authentication scheme set to "Cookies" 

Services.AddAuthentication (options 三 > 

options.DefaultcChallengeSscheme =CookieAuthenticationDefaults.AuthenticationSscheme; 


options.DefaultSiognIinscheme = CookieAuthenticationDefaults.AuthenticationSscheme; 
options .DefaultAuthenticateSscheme = CookieAuthenticationDefaults .AuthenticationScheme; 


}) 

-AddCookie (options => 

{ 
options.LoginPath = new Pathstring("/Account/Login"™);} 
options.Cookie.Name = "YourAppCookieName™} 
options.ExpireTimeSpan = TimeSpan.FromMinutes (60); 
options.SlidingExpiration = true; 
options.AccessDeniedPath = new Pathstring("/Account/Denied"™),，} 

}) 

-AddOpenIdConnect (options 三 > 

{ 


Options .Authority = "http://localhost:6000"; 
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options.ClientId = ” 
options.ClientSecret = " 


}); 

只 需要 在 调用 AddAuthentication 之 后 连接 处 理 程序 定义 。 当 注册 了 多 个 处 理 程 
序 时 ， 必 须 指 定 黑 认 质 询 ， 以 及 首选 的 吴 份 验证 方案 和 登录 方案 。 换 人 句 话 说 ， 当 用 
户 登 录 时 ， 对 用 户 进行 质询 ， 要 求 其 证 明 目 己 的 有 身份 ， 然 后 对 用 户 提供 的 令 牌 进行 
吴 份 验证 ,而 我 们 需要 指定 使 用 哪个 处 理 程 序 来 进行 身份 验证 。 在 每 个 处 理 程序 中 ， 
可 以 重 写 登录 方案 来 满足 上 自己 的 目的 。 


2. 应 用 身份 验证 中 间 件 


与 经 典 ASPNET MVC 相同 ，ASPNET Core 使 用 Authorize 特性 来 修饰 需要 进 
行 喘 份 验 证 的 控制 器 类 和 操作 方法 。 
[Authorizel| 


Public class CustomerController : Controller 


{ 
// All action methods in this controller will 
// be subject to authentication except those explicitly 
// decorated with the AllowAnonymous attribute. 


} 

正如 代 伍 段 中 所 指出 的 ， 还 可 以 使 用 AllowAnonymous 特性 将 特定 的 操作 方法 
标记 为 匿名 的 ， 从 而 不 需要 进行 身份 验证 。 

在 操作 方法 上 使 用 Authorize 特性 限定 了 只 有 经 过 号 份 验证 的 用 户 才能 使 用 该 
操作 方法 。 但 是 ， 如 果 有 多 个 有 身份 验证 中 间 件 可 用 ， 应 访 使 用 哪 一 个 呢 ? ASPNET 
Core 在 Authorize 特性 上 提供 了 一 个 新 属性 ， 人 允许 基于 每 个 请 求 选 择 不 同 的 身份 验 


[Authorize (ActiveAuthenticationSschemes = "Bearer")| 
Public class ApiController : Controller 
{ 


// Your API action methods here 
} 
这 段 代 码 的 效果 是 ， 示 例 类 ApiController 的 所 有 公有 端点 都 可 被 通过 持 有 者 令 
牌号 份 验证 的 用 户 访 问 。 


8.2.3 建 模 用 户 身 份 


任何 登录 到 ASPNET Core 应 用 程序 的 用 户 都 必须 以 某 种 独特 的 方式 进行 描述 。 
在 Web 发 展 的 早期 ，ASPNET Framework 被 首次 设计 出 来 时 ， 仅 使 用 用 户 名 就 足以 
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唯一 标 误 已 登录 的 有 用户 。 事 实 上 , 在 老 版 本 的 ASPNET 中 ， 建 模 用 户 映 份 并 侯 保 存 
到 身份 验证 cookie 中 的 只 有 用 户 名 。 

需要 指出 的 是 ， 关 于 用 户 的 信息 有 两 个 级 别 。 几 乎 所 有 的 应 用 程序 都 有 攻 种 几 
尸 存 储 ， 其 中 保存 了 关于 用 尸 的 所 有 细 市 信息 。 这 类 行 储 中 的 数据 项 有 一 个 主键 和 
许多 描述 性 字段 。 当 用 尸 登 录 到 应 用 程序 时 ， 会 创建 一 个 号 份 验 证 cookie， 并 复制 
一 些 用 户 特定 的 信息 。 全 少 ， 在 cookie 中 必须 保存 在 应 用 程序 后 问 唯 一 标识 用 户 的 
值 。 不 过 ， 喘 份 验 证 cookie 也 可 以 包含 与 安全 环境 严格 相关 的 额外 信息 。 

总 之 ， 在 领域 层 和 持久 化 层 通 毅 有 一 个 实体 来 代表 用 户 ， 并 有 一 个 名 称 / 值 对 的 
集合 所 供 了 从 喘 份 验证 cookie 读 取 的 用 户 的 直接 信息 。 这 些 名 称 / 值 对 被 称 为 声明 。 


1. 声明 简介 


在 ASPNET Core 中 ， 声 明 束 是 身份 验证 cookie 中 存储 的 内 容 。 作 为 开发 人 员 ， 
在 身份 验证 cookie 中 能 够 存储 的 只 有 声明 ， 即 名 称 / 值 对 。 与 过 去 相 比 ， 在 cookie 
中 能 够 添加 的 数据 要 更 多 ， 能 够 百 接 谈 取 而 不 必 从 数据 库 获 取 的 数据 也 更 多 。 

声明 用 来 建 模 用 户 身 份 。 ASPNET Core 正式 提供 了 一 系列 预定 义 的 声明 ， 也 葡 
是 预定 义 的 键 名 称 ， 目 在 存储 一 些 广 泛 需 要 的 信息 。 可 以 定义 其 他 声明 。 最 终 ， 是 
否定 义 声 明 要 由 你 和 你 的 应 用 程序 决定 。 

ASPNET Core Framework 提供 了 一 个 Claim 类 ， 其 设计 基于 下 和 面 的 布局 。 

public class Claim 

{ 


public string Type { get; } 
public string Value { get; } 


public string Issuer { get; | 
Public string Originallssuer { gets; |】 
Public IDictionary<string,: string> Properties { get; } 


// More properties 


} 


声明 有 一 个 属性 说 明了 对 用 户 作 出 的 声明 的 类 型 。 例 如 ， 声 明 类 型 可 以 是 用 户 
在 该 应 用 程序 中 的 角色 .声明 还 有 一 个 字符 串 值 .例如 ,Role 声明 的 值 可 以 是 admin。 
声明 的 描述 包含 原始 颁发 者 的 名 称 ， 当 声明 通过 中 间 颁 发 者 转发 的 时 候 ， 还 会 包含 
实际 颁发 者 的 名 称 。 最 后 ， 声 明 还 可 以 有 其 他 属性 构成 的 一 个 字典 ， 用 来 补充 值 。 
所 有 属性 都 是 只 读 的 ， 构 造 函 数 是 唯一 能 够 保存 值 的 方式 。 声 明 是 不 可 变 的 实体 。 


2. 在 代码 中 使 用 声明 

当 用 户 提供 了 有 效 的 凭据 后 ， 或 者 说 当 用 户 绑 定 到 一 个 已 知 的 身份 后 ， 要 解决 
的 问题 是 如 何 持久 化 基于 识别 出 的 实体 的 关键 信息 。 如 前 所 述 ， 在 老 版 本 的 
ASPNET 中 ， 只 能 存储 用 户 名 。 在 ASPNET Core 中 ， 由 于 使 用 了 声明 ， 表 达能 > 
束 强 得 多 了。 
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为 了 准备 要 存储 到 喘 份 验证 cookie 中 的 用 户 数据 ， 通 种 采 用 下 面 的 方式 : 


// Prepare the list of claims to bind to the user's identity 
Var claims = new Claim|[|| 1 

new Claim(ClaimIypes.Name, "123456189"),， 

new Claim("display name", "Sample User"), 

new Claim(ClaimTypes.Email, "sampleuserlyourapp.com"), 
new Claim("picture url", "\images\sampleuser.jpg"), 

new Claiml("age", "24"), 

mew Claiml("status", "Gold"™), 


new Claim(ClaimIypes.Role, ”Manager ), 


new Claim(ClaimIypes.Role, "Supervisor") 

}; 

// Create the identity object from claims 

Var identity = new ClaimsIdentityl(claims, CookieAuthenticationDefaults. 
AuthenticationSscheme); 


// Create the principal object from identity 
Var principal = new ClaimsPrincipal (identity); 


从 声明 创建 类 型 为 ClaimsIdentity 的 号 份 对 象 ， 从 刁 份 对 象 创 建 关 型 为 ClaimsPrincipal 
的 主体 对 象 。 当 创建 喘 份 时 ， 还 会 指定 站 选 的 映 份 验证 方案 (意味 看 指定 如 何 处 理 声 明 )。 
在 代码 段 中 , 传递 的 CookieAuthenticationDefaults.AuthenticationScheme 值 ( 即 Cookies 的 
字符 串 值 ) 指 定 将 声明 存储 到 号 份 验 证 cookie 中 。 
天 于 上 面 的 代码 段 ， 需 要 注意 两 点 。 
e 上 自 完 ， 声 明 的 类 型 是 一 个 普通 字符 串 值 ， 但 古 对 于 第 用 的 类 型 (如 角色 、 名 
称 或 电子 邮件 )， 存 在 许多 预定 义 的 锅 量 。 可 以 使 用 目 己 的 字符 串 ， 也 可 以 
使 用 ClaimTypes 类 中 的 预定 义 常量 字符 串 。 
e 其 次 ， 在 同一 个 声明 列表 中 ， 可 以 有 多 个 角色 。 


3. 天 于 声明 的 假定 


所 有 声明 都 是 平等 的 ， 但 是 有 一 些 声明 比 其 他 声明 更 加 平等 。Name 和 Role 就 
是 ASPNET Core 基础 结构 中 得 到 (合理 的 ) 特 殊 处 理 的 两 个 声明 。 考 虑 下 面 的 代码 : 

Var claims = new Claiml|l 

{ 


new Claiml("PublicName", userName), 
new Claim(ClaimTypes.Role, userRole), 


// More claims here 

}; 

这 个 声明 列表 中 有 两 个 元 素 : 一 个 名 为 PublicName， 一 个 名 为 Role( 来 日常 量 
ClaimTypes.Roles)。 可 以 看 到 ， 不 存在 名 为 Name 的 声明 。 当 然 ， 这 并 不 是 一 个 钙 
误 ， 因 为 声明 列表 是 完全 由 你 决定 的 。 但 是 ， 有 Name 和 Role 人 至少 是 相当 币 匈 的 。 
ASPNET Core Framework 为 ClaimsIdentity 类 提供 了 一 个 额外 的 构造 冰 数 ， 除 了 声 
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明 列 表 和 身份 验证 方案 之 外 ， 该 构造 函数 还 允许 通过 名 称 指定 给 定 列表 中 保存 号 份 
的 名 称 和 角色 的 声明 。 
Var identity = new ClaimsIdentity(claims, 
CookieAuthenticationDefaults.AuthenticationSscheme, 


"PublicName", 


ClaimTypes.Role); 


这 段 代 个 的 效果 是 ， 名 为 Role 有 的 声明 将 成 为 角色 声明 ， 这 符合 预期 。 无 论 所 供 
的 声明 列表 是 否 包含 一 个 Name 声明 , 都 应 该 使 用 PublicName 这 个 声明 作为 用 户 的 

声明 列表 中 指定 了 名 称 和 角色 ， 这 是 因为 为 了 回 后 兼容 老 版 本 的 ASPNET 代 
但 , 需要 使 用 这 两 条 信息 来 文 持 IPrincipal 接口 的 功能 , 如 IsInRole 和 IdentityName。 
ClaimsPrincipal 类 中 的 IsInRole 的 实现 目 动 使 用 声明 列表 中 指定 的 角色 。 关 似 地 ， 
用 户 的 名 称 将 默认 使 用 Name 状态 指定 的 声明 的 值 。 

总 之 ，Name 和 Role 声明 有 默认 名 称 ， 但 是 可 以 随意 重 写 这 些 名 称 。 重 写 操 作 
是 在 ClaimsIdentity 类 的 重 载 构造 函数 中 实现 的 。 


4. 登录 和 注销 


有 一 个 主体 对 象 是 登录 用 户 的 先决 条 件 。 实 际 登 录用 户 的 方法 是 HITP 上 下 文 
对 和 象 的 Authentication 方法 ， 并 且 登 录 操 作 会 创建 身份 验证 cookie。 


// Gets the principal object 
Var principal = new ClaimsPrincipal (identity); 


// Signs the user in (and creates the authentication cookie) 

awalit HttpContext.SignIinAsync( 
CookieAuthentijcationDefaults.AuthenticationSsScheme, 
principal}); 


准确 来 说 ， 只 有 入 份 验证 方案 被 设 为 cookies 时 ， 登 录 过 程 中 才 会 创建 cookie。 
登录 过 程 中 发 生 的 操作 的 顺序 取决 于 选 定 身份 验证 方案 的 处 理 程序 。 

Authentication 对 象 是 AuthenticationManager 类 的 实例 。 该 类 有 两 个 值得 注意 的 
方法 : SignOutAsync 和 AuthenticateAsync。 从 名 称 中 可 以 猿 到 ， 前 一 个 方法 撤销 号 
份 验证 cookie， 并 使 用 户 注销 应 用 程序 。 


awalt HttpContext.SignOutAsvyncl( 
CookieAuthenticationDefauilts.AuthenticationSscheme);}; 


调用 该 方法 时 ， 必 须 指 定 从 哪个 身份 验证 方案 注销 。AuthenticateAsynec 方法 则 
只 是 验证 cookie， 并 检 得 用 户 是 否 通 过 刁 份 验证 。 而 且 ， 在 这 里 ， 验 证 cookie 的 操 
作 也 是 基于 选 定 的 身份 验证 方案 的 。 
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5. 读 取 声明 的 内 容 


ASPNET Core 身份 验证 的 世界 一 半 是 熟悉 的 ,一 半 是 未 知 的 ， 对 于 有 多 年 的 经 
典 ASPNET 编程 经 验 的 开发 人 员 尤 为 如 此 。 在 经 暴 ASPNET 中 ， 当 系统 处 理 了 身 
份 验 证 cookie 之 后 ， 很 容易 访问 用 户 名 ， 而 用 户 名 是 默认 情况 下 唯一 可 用 的 信息 。 
如 果 必 须 让 更 多 关于 用 户 的 信息 可 用 ， 就 需要 创建 目 己 的 声明 ， 并 把 它们 的 内 容 序 
列 化 到 cookie 中 ， 本 质 上 就 是 创建 日 己 的 主体 对 象 。 近 来 ,经典 ASPNET 中 也 增 
加 了 对 声明 的 支持 。 在 ASPNET Core 中 ， 声 明 是 唯一 可 行 的 方法 。 创 建 自 己 的 主 
体 时 ， 需 要 目 己 负责 谈 取 声明 的 内 容 。 

在 代 公 中 通过 HttpContext.User 属性 访问 的 ClaimsPrincipal 实例 有 一 个 编程 接 
站， 用 于 合 询 具体 的 声明 。 下 面 给 出 了 从 一 个 Razor 视图 中 摘出 的 例子 。 


Qif (User.Identity.IsAuthenticated) 


{ 
var pictureClaim = User.FindFirst ("picture UIL ) 7 
if (pictureClaim ‘= null) 
{ 
VarT picture = pictureClaim.Value; 
<img src—"Rpicture™ alt="" /> 
} 


} 


当 洽 染 页 面 时 ， 可 能 想 显 示 登 录用 户 的 头像 。 假 设 头 像 信息 也 保存 在 声明 中 ， 
那么 上 面 的 代码 显示 了 用 来 查询 声明 的 对 LINQ 友好 的 代码 。FindFirst 方法 只 返回 
具有 相同 名 称 的 声明 (可 能 有 多 个 ) 中 的 第 一 个 。 如 果 想 要 找到 所 有 声明 ， 就 需要 使 
用 FindAll 方法 。 为 读 取 声明 的 实际 值 ， 需 要 展开 Value 属性 。 


注意 : 
当 验 证 了 登录 页 面 的 凭据 后 ， 问 题 就 变 成 如 何 获取 要 保存 到 cookie 中 的 所 有 疡 
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明 。 注 意 ， 在 cookie 中 存储 的 信息 越 多 ， 就 能 够 以 几乎 没有 开销 的 方式 获取 越 多 的 
用 户 信 息 。 有 时， 可 以 在 cookie 中 存储 一 个 用 户 键 ， 当 登录 过 程 开始 时 ， 就 使 用 该 
键 从 数据 库 中 检索 匹配 的 记录 。 这 种 方式 的 开销 更 大 ， 但 可 以 保证 用 户 信 息 始 终 是 
最 新 的 ， 而 且 在 创建 cookie 时 ， 不 需要 注销 再 登录 用 户 就 可 以 进行 更 新 。 声 明 的 实 
际 内 容 应 该 从 你 决定 的 位 置 读 取 。 例 如 ， 声 明 的 内 容 可 来 自 数据 库 、 云 或 Active 
Directory. 


8.2.4 ”外 部 身份 验证 
外 部 身份 验证 指 的 是 使 用 一 个 外 部 的 、 经 过 合理 配置 的 服务 ， 对 进入 网 站 的 用 


户 进行 号 份 验证 。 一 般 来 说 ， 外 部 号 份 验证 是 一 种 双赢 的 局 面 。 对 于 最 终 用 户 来 说 ， 
外 部 号 份 验证 很 有 好 处 ， 使 他 们 不 作为 目 己 想 要 注册 的 每 个 网 站 都 创建 一 个 账 己 。 
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外 部 号 份 验 证 对 于 开发 人 员 也 很 有 好 处 ， 使 得 他 们 不 人 必 深 加 关键 的 样板 代码 ， 并 为 
目 己 建立 的 每 个 网 站 都 存储 和 检查 用 户 的 凭据 。 并 不 是 任何 网 站 都 可 以 作为 外 部 刁 
份 验 证 服务 器 ， 因 为 外 部 身份 验证 服务 闫 必须 具有 特定 的 功能 。 不 过 ， 如 今 几乎 所 
有 的 社交 网 络 都 可 以 作为 外 部 号 份 验证 服务 。 


1. 添加 对 外 部 身份 验证 服务 的 支持 


ASPNET Core 文 持 从 头 开 始 使 用 身份 提供 程序 进行 外 部 身份 验证 。 大 多 数 时 候 ， 
只 需要 安装 合适 的 NuGet 包 。 例如 , 如 果 想 让 用 户 能 够 使 用 Twitter 凭据 进行 身份 验证 ， 
那么 在 项 目 中 首先 要 做 的 是 引用 Microsoft.AspNetCore.Authentication.Twitter 包 ， 并 安 
闭 相 天 的 处 理 程序 : 
Services.AddAuthentication (TwitterDefaults.Authenticatijonscheme) 
.AddTwitter (options 三 > 
{ 
options.SigqnlInSscheme = CookieAuthenticationDefaults.AuthenticatijonSscheme; 
options.ConsumerRKey = "..."? 


options.ConsumerSecret = " 


}); 
SignInScheme 属性 是 用 于 持久 化 得 到 的 吴 份 的 身份 验证 处 理 程 序 的 标识 符 。 在 
本 例 中 ， 将 使 用 身份 验证 cookie。 为 了 但 看 上 述 中 间 件 的 效果 ， 可 添加 一 个 控制 占 
方法 来 触发 基于 Twitter 的 身份 验证 。 下 面 给 出 了 一 个 示例 。 


public async Task ITw1ltterAuth (1) 


{ 
Var props = new AuthenticationProperties 
L 
RedirectUri = "/™" // Where to go after authenticating 
}; 


awajit HttpContext.ChallengeAsync (TwitterDefaults.Authenticationscheme, 
PrIops); 
} 


Twitter 处 理 程 序 的 内 部 机 制 知道 访问 哪个 URL 来 传递 应 用 程序 的 喘 份 (使 用 
者 密 铀 和 使 用 者 机 蜜 )， 并 局 用 用 户 的 验证 。 如 果 一 切 正 稼 ， 将 向 用 户 显示 熟悉 的 
Twitter 号 份 验证 页 面 。 如 果 用 户 在 本 地 设备 上 已 经 通过 了 Twitter 的 号 份 验证 ， 那 
么 上 只 会 要 求 该 用 户 确 认 是 合 可 以 授予 该 应 用 程序 权限 ， 使 其 可 以 代表 目 己 在 
Twitter 上 操作 。 

图 8-1 显示 了 Twitter 的 确认 页 面 , 当 示 例 应 用 程序 符 试 对 用 户 进行 吴 份 验证 时 ， 
就 会 显示 该 贝 面 。 

接 下 来 ， 当 Twitter 成 功 验 证 了 用 户 后 ，SignInScheme 属性 会 告诉 应 用 程序 下 一 
步 要 执行 的 操作 。 如 果 想 要 获得 外 部 提供 程序 (本 例 中 为 Twitter) 返 回 的 声明 的 
cookie, 那么 可 以 使 用 Cookies 这 个 值 。 如 果 想 要 通过 一 个 中 间 表 单 来 查看 并 完成 信 
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恩 ， 那 么 需要 引入 一 个 临时 的 登录 方 宁 ， 将 该 过 程 分 为 两 个 步 怠 。 稍 后 将 讨论 这 种 
于 加 复杂 的 场景 。 现在， 我 们 接 看 介绍 在 比较 简 蛙 的 场景 中 会 发 生 什 么 。 


[<€ | https://apitwitter.com/ocauth/authorize?oauth tcoken=CADW 7 忆 1 的 | pe EO 1 
| Twitter / Authorize an applica... > | 它 


Ed 


account’? 


; NAA4E 
Authorize app Cancel 
By NAA4E 


Www.facebook.com/naadte 


Authorize NAA4E to use your il 


This application will be able to: 
= Read Tweets from your timeline. 


" See Who you follow. 


Will not be able to: 

" Follow new people. 

" Update your profils. 

" Post Tweets for you. 

" Access your direct messages. 
" SBB YOUT email address. 


" See your Twitter password. 


You can revoke access to any application at any time from the Applications tab cf your Settings 
page. 


图 8-1 ”作为 一 个 Twitter 用 户 ， 现 在 你 在 授权 该 应 用 程序 代表 你 进行 操作 


RedirectUri 选项 指定 了 当成 功 完 成 吴 份 验证 后 ， 前 往 什 么 地 方 。 在 只 依赖 于 号 
份 验证 服务 提供 的 声明 列表 这 样 一 个 简单 的 场景 中 ， 无 法 控制 你 知道 的 、 关 于 登录 
系统 的 每 个 用 户 的 数据 。 默 认 情 况 下 ， 不 同 社交 网络 返 回 的 声明 列表 不 是 同 质 的 。 
例如 ， 如 果 用 户 通过 Facebook 连接 ， 可 能 得 到 用 户 的 电子 邮件 地 址 。 但 是 如 果 用 户 
是 通过 Twitter 或 Google 连接 的 ， 可 能 束 得 不 到 电子 邮件 地 址 。 如 果 只 支持 一 个 社 
区 网 络 ， 这 不 是 什么 大 问题 ， 但 是 如 条 文 持 许多 社交 了 网络， 并 且 文 持 的 网 络 数量 会 
随时 间 增 长 ， 那 么 就 需要 建立 一 个 中 间 页 面 来 规范 化 信息 ， 并 让 用 户 输入 目前 缺少 
的 所 有 声明 。 

图 8-2 显示 了 当 访 问 某 个 需要 用 户 登 录 的 受 保护 资源 时 ， 客 户 端 浏览 右 、Web 
应 用 程序 和 外 部 喘 份 验证 服务 之 间 的 工作 流 。 

图 中 显示 了 3 个 框 ， 分 别 代 表 浏 览 器 、Web 应 用 程序 和 身份 验证 服务 。 顶 部 的 
黑色 盘 头 将 “浏览 器 ?” 框 与 “Web 应 用 程序 ” 框 连接 起 来 。 的 部 的 男 一 个 入 头 将 “Web 
应 用 程序 ” 框 与 “浏览 器 ” 框 连接 起 来 。 其 他 灰色 篆 头 显示 了 通过 外 部 服务 验证 用 
户 身 份 时 的 各 个 步 又。 
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目次 


重 定 问 


(身份 验证 服 
务 的 URL) 


浏览 态 癌 令 旬 身份 验证 服务 


pm el 生 ~ 
5 AE. A 上 二 
Cookie 


重 运 访问 


响应 
图 8-2” 当 访问 受 保护 资源 且 通 过 外 部 服务 进行 身份 验证 时 的 工作 流 


2 要 求 完善 言 息 


ES I I 整 。 


Services.AddAuthentication (options 三 > 
{ 
options.DefaultcChallengeSscheme = CookieAuthenticationDefaults. 
AuthenticationSscheme,; 
options.DefaultSigninSscheme = CookieAuthenticationDefaults. 
AuthenticationScheme; 
options.DefaultAuthenticateScheme = CookijeAuthenticationDefaults. 
AuthenticationSscheme; 
}) 
. AddCookie (options 三 > 
{ 
options.LoginPath = new Pathstring("/Account/Login™);} 
options.Cookie.Name = "YourAppCookieName™} 
options .ExpireTimeSpan = TimeSpan.FromMinutes (60); 
options.SlidingExpiration = true; 
options.AccessDeniedPath = new Pathstring("/Account/Denied"™);} 
}) 
-AddTwitter (options => 
{ 
options.SignInSscheme = "TEMP™}; 
opPptions.ConsumerKey = --。- 
options.ConsumerSecret = "..."? 
}) 
.AddCooklie ("TEMP™"); 


当 外 部 的 Twitter 提供 程序 返回 时 , 会 使 用 TEMP 方案 创建 一 个 临时 cookie。 通 
过 在 质询 用 户 的 控制 器 方法 中 恰当 设置 重 定 癌 路 径 , 可 以 检查 Twitter 返回 的 主体 并 
进一步 编辑 。 


public async Task TwitterAuthEx () 
{ 
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Var props = new AuthenticationpPproperties 
{ 
RedirectUri = "/account/external" 
}; 
awajt HttpContext.ChallengeAsync (TwitterDefaults.Authenticatjonscheme, 
props); 
} 


Twitter( 或 使 用 的 其 他 服务 ) 现 在 将 午 定 癌 到 Account 探 制 右 的 Extermal 方法 来 完 
成 工作 流 。 何 时 回调 Exteral 方法 由 你 决定 。 你 可 能 会 想 显 示 一 个 HTML 表 乎 来 收 
集 额 外 的 信息 。 在 构建 这 个 表单 时 ， 可 以 使 用 给 定 主体 的 声明 列表 。 


public async Task<IActionResult> External () 


{ 
Var principal = await HttpContext .AUuthent1IcCateASYynmc (- 工 EMP  ) ， 
// Access the claims on the principal and prepare an HTML 
// form that prompts only for the missing information 
return View(); 

} 


在 保存 已 完成 表单 的 内 容 的 控制 器 方法 内 ， 需 要 执行 几 个 关键 步骤 。 按照 上 面 显示 的 
那样 检索 主体 ， 然 后 登录 cookies 方案 ， 并 注销 临时 的 TEMP 方案 。 代 人 码 如 下 所 示 : 
awalt HttpContext .SlignInAsync (CookieAuthenticationDefaults.AuthenticationSscheme, 


principal); 
await HttpContext.SignoutAsync ("TEMP"); 


注意 : 
在 前 面 的 示例 代码 中 ，TEMP 及 CookieAuthenticationDefaults.AuthenticationScheme 只 
是 内 部 标识 符 ; 只 要 在 整个 应 用 程序 中 保持 一 致 ， 就 可 以 重 命 名 它们 ， 


3. 外 部 身份 验证 的 问题 


对 于 用 户 来 说 ， 通 过 Facebook 或 Twitter 等 进行 外 部 身份 验证 有 时 是 很 酷 的 ， 
但 并 不 总 古 如 此 。 同 样 ， 这 里 要 做 一 个 取舍 。 下 向 介绍 在 应 用 程序 中 使 用 外 部 映 份 
验证 时 会 面临 的 一 些 挑战 。 

首先 ， 用 户 必 须 登 录 到 你 选择 的 社交 网 络 或 刁 份 服务 器 。 他 们 可 能 喜欢 也 可 能 
不 喜欢 使 用 已 有 的 攒 据 。 一 般 来 说 ， 应 该 总 是 只 将 社交 身份 验证 作为 选项 提供 给 上 讨 
户 ， 除 非 应 用 程序 本 肌 与 东 个 社交 网 络 特别 紧密 地 集成 在 一 起 ， 或 者 本 号 的 社交 性 
质 非常 强 ， 以 全 于 完全 依赖 外 部 届 份 验证 也 是 可 以 接受 的 。 上 总 是 应 该 考虑 到 ， 在 你 
文 持 的 社交 网 络 上 ， 用 户 不 一 定 有 账 刻 。 
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从 开发 的 角度 看 ， 外 部 号 份 验证 意味 看 配置 刁 份 验证 的 工作 在 每 个 应 用 程序 中 
都 要 重复 进行 。 大 多 数 时 候 ， 都 必须 处 理 用 户 登 录 ， 并 填 与 所 有 必要 的 字段 ， 这 意 
味 看 束 账 尸 管理 而 言 ， 要 做 大 量 工作 。 最 后 ， 必 须 维护 本 地 用 己 存 储 中 的 账 尸 与 外 
部 账户 之 间 的 关联 。 

最 终 来 看 ， 外 部 号 份 验证 并 不 一 定 是 省 时 的 方法 。 如 琳 应 用 程序 本 喘 的 性 质 决 定 
了 需要 使 用 外 部 喘 份 验证 ， 那 么 应 该 将 其 视 为 提供 给 应 用 程序 用 户 的 一 项 功能 。 


8.3 通过 ASP.NET Identity 进行 用 户 身份 验证 


前 面 介绍 了 在 ASPNET Core 中 进行 用 户 身 份 验证 的 基础 知识 。 但 是 ， 在 用 户 
身份 验证 之 下 有 痢 一 整 餐 功能 体系 ， 钊 被 称 为 成 员 系 统 。 成 员 系 统 并 不 上 只 是 管理 用 
户 身份 验证 和 身份 数据 ， 它 还 处 理 用 户 管理 ， 密 码 哈 希 、 验 证 和 重 置 ， 角 色 及 其 管 
理 ， 甚 全 还 处 理 更 局 级 的 功能 ， 如 双重 身份 验证 (Two-Factor Authentication，2FA)。 

构建 目 定义 成 员 系 统 并 不 是 一 个 庞大 的 任务 ， 但 很 可 能 是 一 个 重复 性 任务 ， 对 
于 构建 的 每 个 应 用 程序 都 需要 重新 执行 。 另 一 方面 , 并 不 容易 把 成 员 系 统 抽象 出 来 ， 
用 极 小 的 开销 在 多 个 应 用 程序 中 重用 。 多 年 来 ， 已 经 有 许多 人 答 试 完成 这 种 目的 ， 
Microsoft 目 己 也 做 过 几 次 。 对 于 成 员 系 统 ， 我 个 人 的 看 法 是 ， 如 果 要 编 扎 和 维护 复 
杂 度 相同 的 多 个 系统 ， 那 么 应 该 投入 一 些 时 间 来 构建 自己 的 系统 ， 并 在 系统 中 构建 
自己 的 扩展 点 。 其 他 时 候 ， 就 要 在 以 下 两 个 极端 之 间 做 出 选择 ， 本 章 前 面 讨论 过 的 
普通 用 户 身 份 验证 或 ASPNET Identity。 


8.3.1 ASP.NET Identity 概述 


ASPNET Identity 是 一 个 完善 的 、 全面 的 、 庞大 的 框架 ,为 成 员 系 统 提供 了 一 个 
抽象 层 。 如 果 只 需要 通过 从 人 简单 数据 库 表 中 读 出 的 普通 凭据 来 验证 用 户 的 身份 ， 那 
么 使 用 ASPNET Identity 是 大 材 小 用 。ASPNET Identity 被 设计 用 来 将 存储 与 安全 层 
解 耦 。 因 此 ， 它 提供 了 一 个 丰富 的 API， 并 且 该 API 有 大 量 扩展 点 ， 供 根据 自己 的 
上 下 文 进 行 调整 。 与 此 同时 ， 它 还 包含 一 个 只 需要 进行 配置 的 API。 

配置 ASPNET Identity 划 味 看 要 指定 存储 层 (包括 关系 型 和 面 问 对 象 型 ) 的 细 让 ， 
以 及 最 能 代表 用 户 的 吴 份 模 型 的 细 季 。 疼 8-3 说 明了 ASPNET Identity 的 架构 。 


1. User Manager 


User Manager 是 一 个 中 央 控 制 台 ， 在 这 里 执行 ASPNET Identity 文 持 的 所 有 操 
作 。 如 前 所 述 ， 它 有 一 个 API， 可 用 来 查询 现 有 用 户 、 创 建新 用 户 ， 以 及 更 新 或 删 
除 用 户 。User Manager 还 提供 了 方法 来 文 持 密码 官 理 、 外 部 登录 、 角 色 管 理 ， 其 全 史 
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高 级 的 功能 ， 如 用 尸 锁定、2FA、 根 据 需要 及 送 电子 邮件 以 及 密 但 强度 验证 。 

在 代码 中 ,通过 UserManager<TUser> 关 的 服务 来 调用 上 述 马 能 。 访 泛 型 闫 型 指 
代 提 供 的 用 户 实体 抽象 。 换 名 话说 ， 通 过 该 类 ， 能 够 对 给 定 用 户 模型 执行 所 有 代码 
中 编号 的 任务 。 


管理 用 户 (CRUD 操 作 ) 
管理 角色 (CRUD 操 作 ) 
， 管理 密码 
"关联 用 户 和 角色 


对 用 户 、 密 码 和 角色 执行 的 所 有 操作 的 低级 接口 
- 插入 Entity Framework Core 
”提供 上 月 定义 存储 的 抽象 


， 实 际 的 数据 存储 
， 任何 版 本 的 SQL Server 和 RDBMS 
， 任何 版 本 的 NoSQL ， 但 是 震 要 编写 一 个 提供 程序 


图 8-3 ASPNET Identity 的 整体 架构 
2. 用 尸身 份 抽 象 


在 ASPNET Identity 中 ， 用 户 喘 份 的 模型 成 为 注入 其 机 制 中 的 一 个 参数 ， 并 量 
由 于 用 户 映 份 抽 象 机 制 和 的 层 的 用 户 存 储 抽 象 ， 其 工作 方式 是 有 些 透 明 的 。 
ASPNET Identity 提供 了 一 个 用 户 基 类 , 其 中 已 经 包含 了 希望 在 用 户 实 体 上 具有 
的 许多 常见 属性 , 例如 主键 、 用 户 名 、 密码 哈 希 、 电子 邮件 地 址 和 电话 号 人 码 。 ASPNET 
Identity 还 提供 了 更 加 复杂 的 属性 ,例如 电子 邮件 确认 、 锁 定 状态 、 访问 失败 计数 以 
及 角色 和 登录 名 列表 。ASPNET Identity 中 的 用 户 基 类 是 IdentityUser。 可 以 直接 使 
用 这 个 类 ， 也 可 以 从 该 类 派生 自己 的 类 。 
public class YourAppUser : IdentityUser 
// App-specific properties 
Public string Picture { get; set; } 
public string Status { get; set; } 
} 
IdentityUser 类 的 某 些 方面 已 被 硬 编码 到 框架 中 。 当 把 该 类 保存 到 数据 库 时 ， 将 
把 Id 属性 视 为 主键 。 这 一 点 不 能 改变 , 不 过 我 也 想不到 有 什么 理由 要 改变 这 种 行为 。 
默认 情况 下 将 主键 作为 一 个 字符 串 ， 但 是 框架 的 设计 对 主键 的 类 型 作 了 抽象 ， 所 以 
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在 从 IdentityUser 派生 时 ， 可 以 修改 主键 的 类 型 。 


public class YourAppUser : lIdentityUser<ijnt> 


{ 
// App-specific properties 
public string Picture { get; set; |] 
public string Status { get set; } 
} 


事实 上 ，Id 属性 的 定义 如 下 所 示 : 


public virtual TKey Id { get; Set } 


注意 : 
目 在 老 版 本 的 ASPNET Identity( 用 于 经 典 ASPNET) 中， 主键 被 呈现 为 一 个 GUID， 
这 在 一 些 应 用 程序 中 造成 一 些 问 题 .在 ASPNET Core 中 ,如 果 愿 意 ,也 可 以 使 用 GUID。 
3. 用 亡 存 储 抽象 
IdentityUser 类 通过 某 些 存储 API 的 服务 存储 到 某 个 持久 化 层 。 最 受 欢迎 的 API 
是 基于 Entity Framework Core 的 ， 但 是 用 户 存 储 的 抽象 性 允许 插入 几乎 任何 知道 如 
何 存储 信息 的 框架 。IUserStore<TUser> 是 主要 的 存储 接口 。 下 面 的 代码 摘 目 该 接口 。 
public interface IUserstore<TUser, jn ITKey> : IDisposable where TUser : class, 


IUser<TRey> 
{ 


Task CreateAsync (TUser user); 
Task UpdateAsync (TUser user); 
Task DeleteAsync (TUser user);} 
Task<TUser> FindByldAsync (TKey userlId); 
Task<TUser> FindByNameAsync (string userName); 
} 
可 以 看 到 ， 抽 和 象 的 是 IdentityUser 类 上 的 普通 CRUD API。 得 询 功 能 相当 基础 ， 
只 允许 按照 名 称 或 ID 检索 用 户 。 
但 是 ， 具 体 的 ASPNET Identity 用 户 存 储 要 比 TUserStore 接口 表现 出 的 复杂 得 
多 。 表 8-2 列 出 了 其 他 功能 的 存储 接口 。 


表 8-2 一 些 额 外 的 存储 接口 


额外 的 接口 目的 
IUserClaimStore 此 接口 中 的 图 数 用 于 存储 用 户 的 声明 。 如 果 将 声明 作为 与 User 实 
体 本 身 的 属性 不 同 的 信息 进行 存储 ， 这 个 接口 很 有 用 
IUserEmailStore 此 接口 中 的 函数 用 于 存储 电子 邮件 信息 ， 例 如 用 于 重 置 密码 的 电 
子 邮 件 
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( 续 表 ) 
额外 的 接口 目的 
IUserLockoutStore 此 接口 中 的 函数 用 于 存储 锁定 数据 ， 以 跟 躁 骏 力 攻击 
IUserLoginStore 此 接口 中 的 函数 用 于 存储 通过 外 部 提供 程序 得 到 的 链接 账户 
IUserPasswordStore 此 接口 中 的 函数 用 于 存储 密码 及 执行 相关 操作 
IUserPhoneNumberStore | 此 接口 中 的 函数 用 于 存储 2FA 中 使 用 的 电话 信息 
IUserRoleStore 此 接口 中 的 函数 用 于 存储 角色 信息 


TUserTwoFactorStore 此 接口 中 的 函数 用 于 存储 与 2FA 相关 的 用 户 信息 


实际 的 用 尸 存 储 实现 了 所 有 这 些 接口 。 如 果 创 建 了 一 个 日 定义 的 用 尸 存储 ， 例 
如 一 个 针对 上 日 定义 SQL Server 架构 或 者 目 定 义 NoSQL 存储 的 用 户 存 储 ， 那 么 需要 
目 己 负责 实现 该 存储 。ASPNET Identity 提供 了 一 个 基于 Entity Framework 的 用 户 存 
储 ， 可 通过 Microsoft.AspNetCore.Identity.EntityFrameworkCore NuGet 包 使 用 。 该 存 
储 文 持 表 8-2 中 列 出 的 所 有 接口 。 


4. 配置 ASP.NET Identity 


为 了 使 用 ASPNET Identity， 首 先 需要 选择 (或 创建 ) 一 个 用 户 存 储 组 件 ， 并 设置 
压 层 数据 库 。 假 设 选择 使 用 Entity Framework 用 户 存 储 ， 那 么 首先 必须 在 应 用 程序 
中 创建 DbContext 类。 第 9 章 在 专门 讨论 Entity Framework Core 时 ， 将 完整 解释 
DbContext 类 及 其 全 部 依赖 所 扮 演 的 角色 。 

何 言 之 , DbContext 类 代表 的 是 在 代码 中 通过 Entity Framework 访问 数据 库 时 使 
用 的 中 心 控制 台 。 在 ASPNET Identity 中 使 用 的 DbContext 类 继承 自 一 个 系统 提供 
的 基 类 (dentityDbContext 类 )， 并 包含 一 个 DbSet 类 ， 用 于 用 户 和 其 他 实体 ， 如 登录 
名 、 声 明和 电子 邮件 。 下 面 显 示 了 如 何 布局 一 个 类 。 

public class YourAppDatabase : lIdentityDbContext<YourAppUser> 

{ 

} 

为 了 配置 连接 到 实际 数据 库 的 连接 字符 串 ， 需 要 使 用 标准 的 Entity Framework 
Core 代码 。 稍 后 以 及 第 9 章 将 话 细 介 绍 相 关内 容 。 

在 IdentityDbContext 类 中 ， 注 入 用 户 身份 类 ， 以 及 其 他 许多 可 选 组 件 。 下 面 给 
出 了 该 类 的 完整 签名 。 

Public class IdentityDbContext<TUser, TROole, TKey,: TUserLogin, TUserRole, 

TUsercCclaim> : DbContext 
where TUser : lIdentityUser<TKey,: TUserLogin, TUserRole, TUserClaim> 


Where TRole : IdentityRole<TRey, TUserRole> 
where TUserLogin : lIdentityUserLogin<TRey> 
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Where TUserRole : IdentityUserRole<TKey> 
where TUserClaim : ldentityUserClaim<TRKey> 


| 

} 

可 以 看 到 ， 在 该 类 中 可 以 注入 用 户 喘 份 、 角 色 类 型 、 用 户 映 份 的 主键 、 用 于 链 
接 外 部 登录 的 类 型 、 用 于 代表 用 户 / 角 色 映 冉 的 类 型 ， 以 及 用 于 代表 声明 的 类 型 。 

局 用 ASPNET Identity 的 最 后 一 步 是 在 ASPNET Core 中 注册 该 框架 。 这 个 步骤 
是 在 局 动 类 的 ConfigureServices 方法 中 完成 的 。 


Public void ConfigureServices (IServiceCollection services) 

{ 
// Grab the connection string to Use (or have it fixed) 
// Assume Configuration is set in the startup class constructor (see Ch.7) 
Var Connstring = Configuration.GetSsection("database"™) .Value; 


// Normal EF code to register a DbContext around a SQL Server database 
Services.AddDbContext<YourAppDatabase> (options 三 > 
options .UseSgqlServer (connstring) ); 


// Attach the previously created DbhContext to the ASP.NET Identity framework 
Services.AddlIdentity<YourAppUser, IdentityRole> () 
.AddEntityFrameworkStores<YourlIdentityDatabase>()，; 
} 


知道 了 使 用 什么 连接 字符 串 连 接 上 自选 的 数据 库 之 后 ， 束 使 用 标准 的 Entity 
Framework 代 公 ， 将 给 定数 据 库 的 DbContext 注入 ASPNET Core 堆栈 中 。 人 然后， 注 
册 用 户 吴 份 朋 色 模 型 、 角 色 身 份 模 型 以 及 基于 Entity Framework 的 用 户 存 储 。 
在 配置 时 ， 也 可 以 为 要 创建 的 身份 验证 cookie 指定 参数 。 下 面 给 出 了 一 个 示例 。 
Services.CconfigureApplicationCookie (options 三 > 
{ 
options.Cookie.HttpOnly = 七 TUGE 7 
options.Cookie.Expiration = TimeSpan.FromMinutes (20) 7 
options.LoginPath = new Pathstring("/Account/Login™); 
options.LogoutPath = new Pathstring("/Account/Logout"™");} 
options.AccessDeniedPath = new Pathstring{("/Account/Denied™).，} 
options.S1idingExpiration = true; 
}); 
类 似 地 ， 还 可 以 修改 cookie 的 名 称 ， 以 及 (一 般 来 说 可 以 ) 获 得 对 cookie 的 完全 


8.3.2 使 用 User Manager 


UserManager 是 一 个 中 心 对 象 , 通过 它 来 基于 ASPNET Identity 使 用 和 管理 成 员 
系统 。 不 需 要 和 下 接 创 建 该 类 的 一 个 实例 ; 当 在 应 用 程序 局 动 时 注册 ASPNET Identity 
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的 时 候 ， 访 类 的 一 个 实例 会 悄悄 注册 到 DI 系统 中 。 


public class AccountController : Controller 


{ 
UserManager<YourAppUser> userManager; 
public AccountController (UserManager<YourAppUser> userManager) 
{ 
userManager = userManager; 
} 
// More code here 
} 


在 需要 使 用 UserManager 的 任何 控制 希 关 中 ， 只 需要 以 未 种 方式 注入 该 对 象 ， 
例如 ， 可 以 像 上 和 面 的 代码 段 一 样 ， 通 过 构造 孙 数 进行 注入 。 


1. 处 理 用 户 


要 创建 新 用 户 ， 需 要 调用 CreateAsync 方法 ， 并 传 入 在 应 用 程序 中 由 ASPNET 
Identity 管理 的 用 户 对 象 。 该 方法 返回 一 个 IdentityResult 值 ， 其 中 包含 了 一 个 错误 对 
象 列 表 ， 以 及 一 个 标志 成 功 或 失败 的 布尔 值 属 性 。 

public class IdentityResult 

{ 

public IEnumerable<IdentityError> Errors { get; } 


public bool Succeeded { get; protected set; | 
} 


public class IdentityError 
{ 
Public string Code { get; set; } 
Public string Description 1{ get; set; | 
} 
CreateAsync 方法 有 了 两 个 重 载 : 一 个 只 接受 用 户 对 象 作 为 参数 ， 另 一 个 还 接受 密 
亿 。 第 一 个 重 载 不 会 为 用 户 设 置 任何 密码 。 通 过 使 用 ChangePasswordAsync 方法 ， 
可 以 在 以 后 设 管 或 者 修改 密 公 。 
当 在 成 员 系 统 中 添加 用 户 时 ， 面 临 着 一 个 问题 ， 如 何以 及 在 什么 地 方 验证 系统 
中 添加 的 数据 的 一 致 性 。 应 该 让 用 户 类 知道 如 何 验证 自身 ， 还 是 应 该 将 验证 逻辑 作 
为 一 个 单独 的 层 进行 部 署 ? ASPNET Identity 选择 了 第 二 种 模式 。 可 以 支持 
IUserValidator<TUser> 接 口 ， 为 给 定 类 型 实现 任意 目 定义 的 验证 带 。 
public interface IUserValidator<TUser> 
{ 


Task<IdentityResult> ValijdateAsync (UserManager<TUser> manager, TUser user) 
} 
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需要 创建 一 个 类 来 实现 该 接口 ， 并 在 应 用 程序 局 动 时 把 它 注 册 到 DI 系统 中 。 

通过 调用 DeleteAsync 方法 ， 可 以 删除 成 员 系 统 中 的 用 户 。 访 方法 的 签名 与 
CreateAsync 相同 。 要 更 新 现 有 用 户 的 状态 ， 有 许多 预定 义 方 法 可 选 ， 例 如 
SetUserNameAsync、SetEmailAsync、SetPhoneNumberAsync、SetIwokFactorEnabledAsync 
等 。 要 编辑 声明 ， 可 以 使 用 AddClaimAsync 和 RemoveClaimAsync， 还 有 类似 的 方 
法 可 用 于 处 理 登 录 。 

每 次 调用 一 个 更 新 方法 时 ， 会 调用 辰 层 的 用 户 存 储 。 作 为 为 外 一 种 方法 ， 可 以 
在 内 存 中 编辑 用 户 对 象 , 然后 使 用 UpdateAsync 方法 ， 以 批 处 理 模 式 应 用 全 部 修改 。 


2. 获取 用 户 


ASPNET Identity 的 成 员 系 统 为 获取 用 户 数据 提供 了 两 种 模式 。 可 以 根据 参数 
(可 以 是 ID、 电 子 邮 件 或 用 户 名 ) 得 询 用 户 对 象 ， 也 可 以 使 用 LINQ。 下 面 的 代码 段 使 
用 了 几 种 查询 方法 。 


var userl awalit userManager.FindBylIdAsync (123426); 


Var userz2 = awalt userManager.FindByNameAsync("dino"); 


Var user3 await userManager.FindByEmailAsync ("dinolyourapp.com"); 


如 果 用 户 存 储 文 持 IQueryable 接口 ,那么 可 以 在 UserManager 对 象 公 开 的 Users 
集合 上 构建 任意 LINQ 查询 。 


Var emalls = userManager.Users.SsSelect(u => u.Email); 


如 果 只 是 需要 一 条 特定 的 信息 ， 例 如 电子 邮件 或 者 电话 号 码 ， 那 么 可 以 使 用 一 
个 API 调用， 如 GetEmailAsync、GetPhoneNumberAsync 等 。 


3. 处 理 窗 码 


在 ASPNET Identity 中 ， 自 动 使 用 RFC2898 算法 进行 1 万 次 迭代 对 密码 进行 哈 希 。 
从 安全 的 角度 看 ， 这 是 存储 密 公 的 一 种 极为 安全 的 方式 。 哈 希 是 通过 IPasswordHasher 
接口 的 服务 实现 的 。 可 以 在 DI 系统 中 添加 一 个 新 的 蛤 希 生成 右 来 蔡 代 系统 提供 的 
哈 希 生成 器 。 

要 验证 蜜 但 的 强度 以 及 拒绝 脆弱 的 密码 ， 可 以 依赖 于 内 置 的 验证 器 基础 结构 并 
对 其 进行 配置 ， 也 可 以 创建 自己 的 验证 器 。 配 置 内 置 的 验证 器 意味 着 设置 密码 的 最 
小 长 度 ， 以 及 决定 是 人 否 必 须 使 用 字母 和 /或 数字 。 下 面 给 出 了 一 个 例子 。 


public void ConfigureServices (IServiceCollection services) 


{ 


Services.Addldentity<YourAppUser, ldentityRole> (options=> 
{ 
// AL least 6 characters long and digits required 
options.Password.RequireUppercase = alse;} 
options.Password.RequireLowercase = false; 
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options.Password.RequireDigit = true; 
options.Password.RequiredLenagth = oe; 
}) 
.AddEntityFrameworkSstores<YourDatabase> ();} 


】 


要 使 用 目 定 义 密 人 码 验 证 右 ， 震 要 创建 一 个 实现 了 PasswordValidator 的 类 ， 并 在 
应 用 程序 局 动 时 , 调用 了 AddIdentity 以 后 , 把 该 类 注册 到 AddPasswordValidator 中 。 


4. 人 处理 角 色 


最 终 ， 角 色 就 是 声明 ,而 且 在 本 草 前 而 也 见 到 过 ， 有 一 个 名 为 Role 的 预定 义 声 

从 抽象 的 角度 讲 ， 角 色 只 是 一 个 字符 串 ， 没 有 权限 和 逻辑 映射 到 该 字符 串 ， 来 
省 述 用 户 在 应 用 程序 中 能 够 扮 滨 的 角色 。 将 逻辑 和 权限 映射 到 角色 能 够 使 应 用 程序 

更 加 符合 现实 和 需要。 但是， 这 是 开 友 人 员 要 做 的 工作 。 

在 成 员 系 统 中 , 角色 的 目的 则 要 具体 得 多 。ASPNET Identity 这 样 的 成 员 系 统 符 
开 有 人员 完 成 了 许多 工作 ， 人 否则 开 肥 人 员 束 必须 做 大 量 工 作 来 人 在 和 获取 用 户 及 其 
相关 信息 。 成 员 系统 做 的 工作 之 一 是 将 用 户 映 射 到 和 角色。 此 时 ， 角 色 束 成 为 用 户 在 
应 用 程序 中 能 够 做 或 不 能 做 的 操作 的 一 个 列表 。 在 ASPNET Core 和 ASPNET 
Identity 中 ， 角 色 是 保存 在 用 户 存 储 中 的 一 个 命名 的 声明 组 。 

在 ASPNET Identity 应 用 程序 中 ， 声 明 、 用 户 、 文 持 的 角色 以 及 用 户 和 角色 之 
间 的 映射 是 分 开 存储 的 。 所 有 涉及 角色 的 操作 都 被 分 组 到 RoleManager 对 象 中 。 与 
UserManager 对 象 类 似 ， 在 应 用 程序 局 动 时 调用 AddIdentity 将 RoleManager 注册 到 
DI 系统 中 。 类 似 地 ， 通 过 DI 将 RolerManasger 的 一 个 实例 注入 控制 器 中 。 角 色 存 储 
在 一 个 独立 的 角色 存储 中 。 在 EF 中 ， 角 色 存 储 就 是 同一 个 SQL Server 数据 库 中 的 
一 个 独立 的 表 。 

在 代码 中 管理 角色 与 在 代码 中 管理 用 户 几 乎 是 完全 相同 的 。 下 面 的 例子 显示 了 
如 何 创建 一 个 角色 。 


// Define the ADMIN role 


Var roleAdmin = new ldentityRole 
{ 

Name = "Admin™" 
}; 


// Create the ADMIN role in the ASP.NET Identity system 


Var result = awalt roleManager.CreateAsync (roleAdmin); 

在 ASPNET Identity 中 ， 除 非 将 用 户 上 映射 到 角色 ， 合 则 角色 不 会 有 效果 。 
Var user = awalt userManager.FindByNameAsync ("dino); 

Var result = awalt userManager.AddToRoleAsync(user, "Admin'); 


不 过 , 要 将 用 户 汪 加 到 角色 , 需要 使 用 UserManager 类 有 API。 际 了 AddToRoleAsync， 
UserManager 还 提供 了 RemoveFromRoleAsync 和 GetUsersInRoleAsync 方法 。 
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5. 验证 用 户 的 身份 


由 于 ASPNET Identity 框架 十 分 复杂 ， 使 用 该 框架 对 用 户 进行 喘 份 验证 需要 许 
多 步骤 。 这 些 步骤 涉及 的 操作 包括 验证 凭据 、 处 理 失 败 的 登录 答 试 及 锁定 用 户 、 处 
理 禁 用 的 用 户 ， 以 及 处 理 2FA 逻辑 (如 果 启 用 了 该 功能 )。 然 后 ， 必 须 使 用 声明 填充 
ClaimsPrincipal 对 象 ， 并 发 出 喘 份 验 证 cookie。 

所 有 这 些 步 又 都 封装 在 SignInManager 类 公开 的 API 中 。 通过 DI 获取 登录 管理 
髓 的 方式 与 UserManager 和 RoleManager 对 象 相同 。 为 了 执行 登录 页 面 的 所 有 步骤 ， 
需要 使 用 PasswordSienInAsync 方法 。 


public async Task<IActionResult> Login(string user, string password, bool 


rememberMe) 
{ 
Var shouldConsiderLockout = true; 
Var result = awalt signIinManager.PasswordSsignlinAsync ( 


user,: password, rememberMe, shouldConsiderLockout); 
i (result.Succeeded) 
{ 


// Redirect where needed 


} 
return Viewl(" error , result):; 
} 
PasswordSignInAsync 方法 接受 用 户 名 和 密码 (明文 ) 作 为 参数 ， 并 使 用 两 个 布尔 
值 标志 来 指定 得 到 的 身份 验证 cookie 的 持久 化 特征 ， 以 及 是 否 考虑 锁定 。 
注意 : 


用 户 锁定 是 ASPNET Identity 内 置 的 一 项 功能 ， 可 禁止 用 户 登 录 系 统 。 有 两 条 
信息 控制 着 此 功能 : 应 用 程序 是 否 启 用 了 锁定 以 及 锁定 的 结束 日 期 。 有 一 些 专门 的 
方法 可 启用 和 禁用 锁定 ， 以 及 设置 锁定 的 结束 日 期 。 如 果 锁 定 被 禁用 ， 或 者 虽然 锁 
定 被 启用 ， 但 是 当前 日 期 已 经 超出 了 锁定 的 结束 日 期 那么 用 户 就 是 活跃 的 。 


如 隶 过 三 的 结果 包含 在 SignInResult 类 型 中 , 该 类 型 说 明了 身份 验证 是 奋 成 功 、 
合 是 必 


2FA 是 要 的 或 者 用 户 是 否 被 锁定 。 


8.4 授权 策略 


软件 应 用 程序 的 授权 层 确保 了 能 够 允许 当前 的 用 户 访问 指定 和 资源、 执行 指定 损 
作 或 者 在 指定 资源 上 执行 指定 操作 。 在 ASPNET Core 中 ， 有 两 种 方法 可 设置 授权 
乓 : 使 用 角色 或 使 用 策略 。 前 一 种 方法 ( 即 基于 角色 的 授权 ) 是 以 前 版 本 的 ASPNET 
平台 就 有 的 。 基 于 策略 的 授权 则 是 ASPNET Core 中 全 新 引入 的 ， 非 常 强 大 和 灵活 。 
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8.4.1 基于 角色 的 授权 


授权 比 号 份 验 证 更 进一步 。 身 份 验证 是 为 了 发 现 用 户 的 映 份 ， 跟 踪 其 活动 ， 并 
只 允许 已 知 的 用 户 进 入 系统 。 授 权 则 更 加 具体 ， 为 用 户 调用 预定 义 的 应 用 程序 端点 
定义 了 条 件 。 受 到 权限 控制 并 进而 受到 授权 层 控 制 的 任务 的 常见 示例 包括 显示 或 隐 
北 用 户 界 面 元 素 、 执 行 操 作 或 者 流转 到 其 他 服务 。 在 ASPNET 中 ， 从 早期 开始 ， 角 
色 一 直 是 实现 授权 层 的 常见 方式 。 

从 技术 上 讲 ， 角 色 就 是 一 个 普通 的 字符 串 ， 没 有 关联 的 行为 。 但 是 ，ASPNET 
和 ASPNET Core 的 安全 层 将 角色 的 值 视 为 元 信息 。 例 如 ， 这 两 个 安全 层 都 会 检查 
主体 对 象 中 是 合 包含 角色 (参见 主体 的 吴 份 对 象 中 的 IsInRole 方法 )。 除 此 之 外 ， 应 
用 程序 会 使 用 角色 加 属于 该 角色 的 所 有 用 户 授予 权限 。 

在 ASPNET Core 中 ， 和 角色 信 息 在 已 登录 用 户 的 声明 中 是 否 可 用 要 取决 于 后 备 
身份 存储 。 例 如 ， 如 果 使 用 社交 身份 验证 ， 那 么 根本 不 会 看 到 角色 。 通 过 Twitter 
或 Facebook 进行 喘 份 验证 的 用 户 不 会 携带 任何 对 你 的 应 用 程序 有 意义 的 角色 信息 。 
但 是 ， 你 的 应 用 程序 可 能 基于 内 部 的 和 领域 特定 的 规则 ， 为 该 用 户 分 配 一 个 角色 。 

总 之 ， 角 色 只 是 元 信息 ， 应 用 程序 一 一 也 只 有 应 用 程序 一 一 可 将 其 转换 为 做 或 
者 不 做 特定 操作 的 权限 。ASPNET Core Framework 只 提供 了 一 点 基础 结构 来 持久 化 
和 获取 和 角色。 支持 的 角色 以 及 用 户 与 角色 的 映射 的 列表 通常 存储 在 底层 的 成 员 系 统 
中 (可 能 是 自 定 义 的 ， 也 可 能 基于 ASPNET Identity)， 当 验证 用 户 凭 据 的 时 候 会 获取 
这 个 列表 。 接 下 来 ， 角 色 信 息 将 以 某 种 方式 关联 到 用 户 账户 并 公开 给 系统 。 喘 份 对 
象 (在 ASPNET Core 中 为 ClaimsIdentity) 上 的 IsInRole 方法 是 用 于 实现 基于 角色 的 授 
权 的 杠杆 。 


1. Authorize 特性 
Authorize 特性 以 声明 的 方式 来 保护 控制 器 或 控制 器 的 一 些 方法 。 


[Authorizel| 
public class CustomerController : Controller 


{ 
} 


注意 ， 如 果 没 有 指定 参数 ， 那 么 Authorize 特性 只 检查 用 户 是 否 通 过 身份 验证 。 
在 上 面 的 代码 段 中 ,所 有 成 功 登 录 系 统 的 用 户 都 能 够 调用 CustomerController 类 的 任 
意 方法 。 要 想 只 选择 用 户 的 一 个 子 集 ， 需 要 使 用 角色 。 

Authorize 特性 的 Roles 属性 指明 , 只 有 属于 列 出 的 任意 角色 的 用 户 才 会 被 授 
权 访 问 探 制 器 的 方法 。 在 下 和 面 的 代 人 码 中 ，Admin 和 System 用 户 都 可 以 调用 
BackofficeController 类 的 方法 。 
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[Authorize (Roles="Admin, SYSstem  ) 
public class BackofficeController : Controller 


{ 


[Authorize (Roles="System")l| 
public IActionResult Reset () 


{ 
// You MUST be a SYSTEM user to get here 
} 
[Authorizel| 
public IActionResult Publicl) 
{ 
// You just need be authenticated and can View this 
// regardless of role(s) assigned to vyou 
} 


[AllowAnonymous)| 
Public IActionResult Index |() 


{ 
// You don't need to be authenticated to get here 


} 
Index 方法 不 要 求 身 份 验证 。Public 方法 只 要 求 用 户 通过 喘 份 验证 。Reset 方法 
则 严格 要 求 用 户 是 System 用 户 。 其 他 所 有 方法 都 可 和 被 Admin 或 System 用 户 调用 。 
如 果 需 要 多 个 角色 才能 访问 控制 器 ， 那 么 可 以 多 次 应 用 Authorize 特性 。 或 者 ， 
可 以 编写 目 己 的 授权 和 贤 选 器 。 在 下 和 面 的 代码 中 ， 只 有 上 有 具有 Admin 和 System 角色 的 
用 户 才 能 获得 调用 控制 器 的 权限 。 
[Authorize (Roles="Admin™") | 


[Authorize (Roles="System")| 
public class BackofficeController : Controller 


{ 


} 
作为 可 选项 ，Authorize 特性 还 可 以 通过 ActiveAuthenticationSchemes 属性 接受 
一 个 或 多 个 映 份 验 证 方 条 。 


[Authorize (Roles="Admin, System", ActijveAuthenticationschemes="Cookies"| 
public class BackofficeController : Controller 


{ 

} 

ActiveAuthenticationSchemes 属性 是 一 个 有 逗号 分 陋 的 字符 串 , 列 出 了 授权 层 在 当 
前 上 下 文 内 信任 的 映 份 验 证 组 件 。 换 句 话 说 ， 它 指定 了 只 有 当 用 户 通 过 Cookies 方 
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案 进 行 喘 份 验 证 并 且 具 有 列 出 的 任意 角色 时 ， 才 能 访问 BackofficeController 类 。 如 
前 所 述 ， 传 递 给 ActiveAuthenticationSchemes 属性 的 字符 串 值 必须 符合 在 应 用 程序 
启动 时 注册 到 身份 验证 服务 的 处 理 程序 。 因 而 ， 身 份 验证 方案 本 质 上 就 是 一 个 选择 
处 理 程序 的 标签 。 


2. 授权 筛 选 器 


Authorize 特性 提供 的 信息 由 一 个 预定 义 的 、 系 统 提供 的 授权 竹 选 器 使 用 。 此 得 
选 器 在 其 他 任何 ASPNET Core 筛 选 器 之 前 运行 ， 因 为 它 负责 检 查 用 户 是 否 能 够 执 
行 请 求 的 操作 。 如 果 不 能 ， 授 权 筛 选 器 将 使 管道 短路 ， 取 消 当前 的 请 求 。 

可 以 创建 目 定 义 的 授权 簿 选 器 ， 但 是 通 第 不 需要 这 么 做 。 事 实 上， 更 好 的 方法 
是 配置 默认 筛选 器 所 依赖 的 现 有 授权 层 。 


3. 角色 、 权 限 和 人 否决 


角色 是 基于 用 户 能 够 或 者 不 能 够 做 的 操作 ， 将 应 用 程序 的 用 记分 组 到 一 起 的 一 
种 简单 的 方法 。 但 是 ， 角 色 的 表达 力 人 不是 特别 强 ; 全 少 不 足 以 满足 大 部 分 现代 旋 用 
程序 的 需要 。 人 例如， 考虑 一 个 相对 简单 的 授权 如 构 : 网 站 中 包含 普通 用 户 ， 也 包 合 
有 权 访 问 后 端 办 公 系 统 和 更 新 内 容 的 超级 用 户 。 基 于 角色 的 授权 层 可 基于 两 种 角色 : 
用 尸 和 管理 员 。 以 此 为 基础 ， 定 义 每 组 用 尸 能 够 访问 哪些 控制 占 和 方法 。 

问题 是 ， 在 现实 世界 中 ， 场 景 很 少 这 么 简单 。 在 现实 世界 中 ， 旬 和 贡 要 细致 地 区 
分 给 定 用 户 角 色 中 的 用 己 能 够 做 什么 和 不 能 做 什么 。 有 了 角色 后 ， 还 需要 确定 一 些 
例外 情况 和 和 否决 情况 。 例 如 ， 在 能 够 访问 后 咒 办 公 系 统 的 用 尸 中 ， 有 些 上 只 能 编辑 客 
户 数据 ， 有 些 具 能 处 理 内 容 ， 有 些 能 够 进行 上 述 两 种 操作 。 如 何 呈 现 图 8-4 这 样 的 
授权 方案 呢 ? 


图 8-4 角色 和 角色 的 否决 


这 是 一 个 由 方 框 和 箭头 构成 的 示意 图 。“ 用 户 ” 框 和 “管理 员 ” 框 是 灰色 显示 的 ， 
“管理 员 ” 框 向 外 伸 出 一 些 箭头 ， 将 其 连接 到 了 “客户 “内 容 ”和 “客户 + 内 容 ” 杠 

角色 本 质 上 是 局 平 的 概念 。 如 何 让 一 个 层次 结构 (即使 是 图 8-4 中 显示 的 这 样 一 
个 向 单 的 层次 结构 ) 忆 平 化 呢 ? 例如 ， 可 以 创建 4 个 不 同 的 角色 : User、Admin、 
CustomerAdmin 和 ContentsAdmin。Admin 角色 是 CustomerAdmin 和 ContentsAdmin 


的 并 集 。 这 种 方法 是 可 以 工作 的 ， 但 是 当 否 决 一 一 人 筷 们 完全 是 业务 特定 的 一 一 的 数 
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量 增长 时 ， 需 要 的 角色 的 数量 也 会 显著 增长 。 

关键 在 于 ， 角 色 不 一 定 是 处 理 授 权 的 最 有 效 方式 ， 不 过 它们 对 于 辣 后 兼容 以 及 
在 一 些 非 党 简单 的 场景 中 是 非 芝 有 用 的 。 对 于 其 他 场景 ， 则 需要 不 同 的 方案 。 这 时 
候 要 用 到 基于 策略 的 授权 。 


8.4.2 ”基于 策略 的 授权 


在 ASPNET Core 中 ， 基 于 策略 的 授权 框架 被 设计 用 于 使 授权 逻辑 和 应 用 程序 
逻辑 分 离开 。 策 略 是 一 个 实体 ， 被 设计 为 一 个 需求 集合 。 需 求 就 是 当前 用 户 必须 满 
足 的 一 个 条 件 。 最 简单 的 策略 是 用 户 必须 经 过 身份 验证 。 另 一 个 常见 的 需求 是 用 户 
属于 指定 的 角色 stole ba 用 户 必须 有 特定 的 声明 ， 或 者 
不 但 必须 有 一 个 特定 的 声明 ， 该 声明 还 必须 有 特定 的 值 。 一 般 来 说 ， 需 求 是 关于 用 
PN OR row 


1. 定义 授权 策略 
使 用 下 面 的 代码 创建 策略 对 象 : 


Var policy = new AuthorizationPolicyBuilder() 
-AddAuthenticationSschemes ("Cookie, Bearer") 
-RequireAuthenticatedUser () 

.RequireRole ("Admin™) 
-RequireClaim("editor", "contents") 
-RequireClaim("level™“, "senior™.) 
.Build(); 


生成 器 对 象 使 用 多 个 扩展 方法 收集 需求 ， 然 后 生成 策略 对 象 。 可 以 看 到 ， 需 求 
会 处 理 通过 身份 验证 cookie( 或 者 如 果 使 用 的 是 持 有 者 令 牌 ， 就 从 持 有 者 令 牌 ) 读 出 的 
身份 验证 状态 和 方案 、 角 色 以 及 任意 声明 组 合 。 


壮 忌 : 
DD 持 有 者 令 牌 可 替代 身份 验证 cookie， 保 存 关 于 用 户 身 份 的 信息 。 通 第 ， 非 浏览 
器 客户 端 (如 移动 应 用 程序 ) 调 用 的 Web 服务 会 使 用 持 有 者 令 牌 .第 10 章 将 讨论 持 有 
者 令 牌 。 


如 采 所 有 用 来 定义 需求 的 预定 义 扩 展 方 法 都 不 能 满足 要 求 ， 那 么 总 是 可 以 通过 
目 己 的 断言 来 定义 一 个 新 需求 。 实 现 方法 如 下 ; 


Var policy = new AuthorizationPolicyBuilder () 
-AddAuthenticationSschemes ("Cookie, Bearer"™) 
-RequijreAuthenticatedUser () 

. RequjreRole ("Admin™) 
.RequireAssertion (ctx 三 > 


{ 
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return ctx.User.HasClaiml("editor", "contents™) || 
ctx.User.HasClaim("level", "senior™); 


}) 
.Build(); 
RequireAssertion 方法 接受 一 个 Lambda 函数 , 该 Lambda 函数 接受 一 个 HttpContext 
对 象 ， 返 回 一 个 布尔 值 。 因 此 ， 断 言 是 一 个 条 件 语句 。 注 意 ， 如 有 果 在 策略 的 定义 中 
多 次 连接 RequireRole， 那 么 用 户 必须 具有 上 所 有 指定 的 角色 。 反 过 来 ， 如 果 想 表达 一 
个 OR 条 件 ， 那 么 加 需 要 使 用 断言 。 事 实 上， 在 上 和 面 的 例子 中 ， 策 略 允 许 的 用 户 可 
以 是 内 容 编辑 者 或 者 高 级 用 户 。 
定义 了 策略 后 ， 还 必须 将 其 注册 到 授权 中 间 件 中 


2. 注册 策略 


授权 中 间 件 首先 在 局 动 类 的 ConfiegureServices 方法 中 注册 为 一 个 服务 。 在 此 过 
程 中 ， 会 用 所 有 必要 的 策略 来 配置 该 服务 。 可 通过 一 个 生成 器 对 象 来 创建 策略 ， 并 
通过 AddPolicy 扩展 方法 来 添加 (或 只 是 声明 ) 它 。 


services.AddAuthorization (options=> 


{ 
options.AddPolicyl("ContentsEditor", policy 三 > 
{ 
policy.AddAuthenticationSchemes (CookieAuthenticationDefaults. 
AuthenticatijonSscheme); 
Policy.RequijreAuthenticatedUser (); 
Policy.RequijreRole("Admin™}; 
Policy.RequijreClaim("editor", "contents" ) 
}); 
}; 


深 加 到 授权 中 间 件 的 每 个 策略 部 有 一 个 名 称 ， 访 名称 将 用 于 在 控制 右 类 的 
Authorize 特性 内 引用 对 应 的 策略 。 下 和 面 显 示 了 如 何 通 过 设 莹 一 个 策略 而 个 是 角色 ， 
在 控制 堆 方 法 上 定义 权限 。 

[Authorize (Policy = "ContentsEditor")| 


Public IActionResult Save (Article article) 


{ 


} 
通过 Authorize 特性 ， 可 以 用 声明 的 方式 设置 策略 ， 人 允许 ASPNET Core 的 授权 
层 在 方法 执行 前 强制 实施 策略 。 或 者 ， 可 以 通过 编程 的 方式 强制 实施 策略 。 需 要 的 


public class AdminController : Controller 
{ 


private IAuthorizatiljonSservice authorization; 
Public AdminController (IAuthorizatijonService authorizationService) 


{ 
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authorization = authorizationSservice; 
} 
public async Task<IActijonResult> Save (Article article) 
{ 
Var allowed = awalt authorization.AuthorizeAsync 
User, "ContentsEditor™); 
ift (lallowed.Succeeded) 
return new ForbiddenRrResult (); 
// Proceed with the method implementation 


十 授权 服务 的 引用 也 是 通过 DI 注入 的 。AuthorizeAsync 方法 接受 应 用 程序 
的 主体 对 象 和 策略 名 称 ， 返 回 一 个 AuthorizationResult 对 象 ， 该 对 象 中 包含 一 个 
Succeeded 布尔 值 必 性 。 当 该 属性 的 值 为 false 时 ， 可 通过 Failure 属性 的 FailCalled 
或 FailRequirements 了 解 失败 的 原因 。 如 果 检 查 权 限 的 代码 失败 ， 那 么 应 该 返回 一 
个 ForbiddenResult 对 象 。 


注意 : 

当权 限 检查 失败 时 , 返回 ForbiddenResult 与 返回 ChallengeResult 有 一 个 细小 区 
别 ; 如 果 将 ASPNET Core 1.x 纳入 考虑 范围 ， 则 这 种 区 别 更 加 难以 捉摸 。 
ForbiddenResult 是 一 个 干净 利落 的 回答 一 一 你 失败 了 ， 然 后 返回 一 个 HTTP 401 状 
态 码 。ChallengeResult 是 更 加 友好 的 响应 。 如 果 用 户 已 经 登录 ， 它 会 姓 致 得 到 
ForbiddenResult; 如 果 用 户 还 未 登录 , 就 重 定 向 到 登录 页 面 , 但 是 , 从 ASPNET Core 
2.0 开始 ，ChallengeResult 不 再 将 未 登录 用 户 重 定向 到 登录 页 面 。 因 此 ， 在 响应 权限 
检查 失败 的 情况 时 ，ForbiddenResult 是 唯一 合理 的 方式 。 


3. Razor 视图 中 的 策略 
到 现在 为 止 ， 我 们 已 经 看 到 了 控制 器 方法 中 的 策略 检查 。 在 Razor 视图 中 ， 尤 


其 是 当 使 用 第 5 章 讨 论 的 Razor 外面 的 时 候 ， 也 可 以 执行 相同 的 检 合 。 

@ 1 

Var authorized = awalt Authorization.AuthorizeAsync (User, "ContentsEditor") 
} 
Qif (lauthorized) 
{ 

<div class="alert alert-error™"> 

YOU ' ITe not authorized to access this page. 

</div> 

} 


要 想 使 上 和 面 的 代码 可 以 工作 ， 前 先 必须 注入 对 授权 服务 的 依赖 。 
Qinject IAuthorizationService Authorization 


在 视 岁 中 使 用 授权 服务 可 以 帮助 隐 攻 当前 用 户 无 权 碍 看 的 用 户 界 面部 分 。 
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重要 / 


仅仅 基于 对 授权 的 权限 进行 检查 来 显示 或 隐藏 用 户 界面 元 素 ( 如 指向 受 保 护 页 
面 的 链接 ) 并 不 足以 保证 安全 。 只 要 也 在 控制 器 方法 级 别 进 行 权限 检查 ,那么 这 么 做 
是 可 以 的 。 记 住 ， 控 制 器 方法 是 访问 系统 后 端的 唯一 方式 ， 而 人 们 总 是 可 以 通过 在 
浏览 器 中 键入 URL 来 试图 直接 访问 页 面 。 隐 藏 链接 并 不 是 绝对 安全 的 。 理 想 的 方 
法 是 在 入 口 处 检查 权限 ,而 入 口 就 是 控制 器 级 别 。 唯一 的 例外 是 ， 从 ASPNET Core 
2.0 开始 ， 使 用 的 二 Razor 页 面 。 


4. 目 定 义 需求 


笛 见 需求 敌 再 了 声明 和 吴 份 验证 ， 并 为 基于 断言 进行 目 定 义 提 供 了 一 个 通用 的 
机 制 。 我 们 也 可 以 创建 目 定义 需求 。 策 略 需 求 由 两 个 元 聚 组 成 : 只 用 于 你 存 数据 的 
需求 类 ， 以 及 验证 用 户 数 据 的 授权 处 理 程 序 。 如 琳 使 用 功用 工具 不 能 表达 目 己 期 望 
的 策略 ， 那 么 可 以 创建 目 定 义 需求 。 
举 个 例子 ， 假 设 我 们 想 扩展 ContentsEditor 策略 ， 添 加 一 个 需求 来 要 求 用 户 必 
须 有 全 少 3 年 的 经 验 。 下 向 给 出 了 一 个 目 定义 需求 的 示例 类 。 


public class ExperlienceRequirement : IAuthorizationRegquirement 


{ 
Public int Years { get; private set; } 
public ExperienceReaquirement (int minimumYears) 
{ 
Years = minimumYears; 
} 
} 


需求 必须 人 至少 有 一 个 授权 处 理 程序 。 处理 程序 是 一 个 类 型 为 AuthorizationHandler<T> 
的 类 ， 其 中 工 是 需求 的 类 型 。 下 面 的 代码 显示 了 ExperienceRequirement 类 型 的 一 个 
示例 处 理 程序 。 


public class ExperienceHandler : AuthorizationHandler<ExperlienceRequirement> 
{ 
protected override Task HanaqdleRedulITrementaAsyYnc ( 
AuthorizationHandlerContext context, 
ExperienceRequirement requlirement) 


// Save User object to access claims 

Var User = context .User; 

if (luser.HasClaim(c => c.Type == "EditorSince™)) 
return Task.CompletedTask:; 


Var since = int.Parse (user.FindFirst ("EditorSince™ ) .Value); 
if (since >= requirement .Years) 
context.Succeed (requirement);} 
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return Task.CompletedTask; 
} 
} 


示例 授权 处 理 程序 谈 取 与 用 尸 关 联 的 声明 ,并 碍 找 一 个 目 定 义 的 EditorSince 声 
明 。 如 采 没 有 找到 ， 融 不 作 处 理 ， 下 接 返回 。 只 有 当 该 声明 人 存在， 并且 包含 的 整数 
值 不 小 于 指定 的 年 数 时 ， 处 理 程序 才 会 返回 成 功 。 目 定义 声明 应 当 是 以 菏 种 方式 关 
联 到 用 户 的 信息 ， 如 Users 表 中 的 一 列 ， 并 保存 到 映 份 验证 cookie 中 。 但 是 ， 当 获 
得 了 双 用 户 的 引用 后 ， 总 是 可 以 入 声明 中 获得 用 户 名 ， 然后 对 数据 库 或 外 部 服务 运 
行 租 询 ， 获 知 用 户 有 多 少年 的 经验 ， 之 后 在 处 理 程序 中 使 用 这 条 信 筷 。 


) 王 局 
当然 ， 在 上 面 的 示例 中 ， 如 果 EditorSince 包含 一 个 DateTime 值 ， 并 计算 从 用 户 
成 为 一 个 Editor 以 后 是 否 已 经 经 过 了 给 定 的 年 数 ， 那 么 该 示例 会 更 加 符合 现实 需要 . 


授权 处 理 程序 调用 Succeed 方法 ， 表 明 需 求 已 被 成 功 验证 。 如 条 需求 没有 通过 
验证 ， 则 处 理 程序 不 需要 作 任 何 处 理 ， 可 以 直接 返回 。 但是， 如 果 处 理 程序 想 要 确 
定 需 求 的 失败 原因 ， 而 不 考虑 针对 相同 需求 的 其 他 处 理 程序 可 能 会 成 功 ， 那 么 可 以 
调用 授权 上 下 文 对 象 的 Fail 方法 。 


重要 / 


一 般 来 说 ， 应 该 把 在 处 理 程序 中 调用 Fail 视 为 一 种 例外 情况 。 事 实 上 ， 授 权 处 
理 程序 一 般 要 么 成 功 ， 要 么 什么 都 不 做 ， 因 为 一 个 需求 可 以 有 多 个 处 理 程序 ， 其 他 
处 理 程 序 可 能 会 成 功 。 当 在 一 些 关 键 的 场景 中 想 要 不 计 后果 地 不 让 其 他 任何 处 理 程 
序 成 功 时 ， 可 以 选择 调用 Fail。 还 要 注意 ， 即 使 在 代码 中 调用 了 Fail， 授 权 层 也 会 
对 其 他 需求 求 值 ， 因 为 处 理 程序 可 能 会 产生 一 些 副 作用 ， 如 日 志 记录 。 


eanal eal mina 由 于 这 和 是 一 个 目 定义 需求 ， 所 以 
没有 扩展 方法 ， 必 须 通 过 妥 略 对 象 的 Requirements 集合 执行 操作 。 
services.AddAuthorization (options 三 > 


{ 
options.AddPolicyl("AtLeast3Years", 


policy => policy 
. Requlirements 
.Add (new ExperlenceReqgqulrement (3))); 


}); 
此 外 ， 必 须 把 新 的 处 理 程 序 注册 到 DI 系统 中 的 IAuthorizationHandler 类 型 下 。 
services.AddSingleton<IAuthorizationHandler, ExperienceHandler> () ， 


如 前 所 述 ， 需 求 可 以 有 多 个 处 理 程序 。 当 在 DI 系统 中 为 授权 层 的 同一 个 需求 
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注册 了 多 个 处 理 程序 时 ， 全 少 有 一 个 成 功 束 够 了 。 
在 授权 处 理 程序 的 实现 中 ， 有 时 可 能 必须 检查 请 求 的 属性 或 者 路 由 数据 。 


if (context.Resource 1s AuthorizationFilterContext) 


{ 
Var url = mvc.HttpContext.Request .GetDisplavyUrl (); 


} 


在 ASPNET Core 中 ，AuthorizationHandlerContext 对 象 公 开 了 一 个 Resource 属 
性 ， 将 其 设 为 利 选 器 上 下 文 对 象 。 取 决 于 涉及 的 框架 ， 上 下 文 对 象 会 有 所 不 同 。 例 
如 ,MVC 和 SignalR 会 发 送 自己 的 上 下 文 对 象 , 是 否 要 强制 转换 Resource 属性 的 值 ， 
取决 于 要 访问 的 内 容 。 例 如 ，User 信息 始终 是 存在 的 ， 并 不 需要 进行 转换 。 但 是 ， 
如 果 想 要 获得 MVC 特定 的 细节 ， 如 路 由 或 URL 和 请 求 信 息 ， 束 必须 进行 转换 。 


8.5 ”小 结 


为 保护 ASPNET Core 应 用 程序 的 安全 ， 需 要 经 过 两 个 层 : 身份 验证 层 和 授权 
层 。 刁 份 验证 的 目的 是 将 来 自 特 定 用 户 代理 的 请 求 关 联 到 一 个 身份 。 授 权 的 目的 是 
检 答 该 身份 是 合 能 够 以 落 种 方式 执行 其 请 求 的 操作 。 

号 份 验证 可 以 使 用 一 个 基本 API 来 创建 身份 验证 cookie， 或 者 也 可 以 依赖 一 个 
专用 框架 的 服务 ， 该 框架 即 ASPNET Identity， 提 供 了 一 个 可 高 度 定制 的 成 员 系 统 。 
授权 分 为 两 种 形式 。 一 种 是 传统 的 、 基 于 角色 的 授权 ， 工 作 方式 与 在 经 典 ASPNET 
MVC 中 相同 。 另 一 种 是 基于 策略 的 授权 ， 这 是 一 种 新 方法 ， 提 供 了 一 种 更 加 丰 军 、 
表达 力 更 强 的 权限 模型 。 策 略 是 需求 和 上 自 定义 逻辑 的 集合 ， 需 求 基于 声明 ， 而 自 定 
义 逻 辑 则 基于 可 从 HTTP 上 下 文 或 外 部 源 注入 的 其 他 任何 信息 。 需 求 关联 厦 一 个 或 
多 个 处 理 程序 ， 处 理 程 序 负责 实际 对 需求 求 值 。 

在 讨论 ASPNET Identity 时 ， 我 们 简单 提 到 了 一 些 数据 库 相 关 的 对 象 和 概念 。 
在 第 9 章 ， 我 们 将 介绍 ASPNET Core 中 的 数据 访问 。 
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第 日 这 


访问 应 用 程序 数据 


隐藏 起 你 的 无 知 ， 就 不 会 有 人 打击 你 ， 但 是 你 也 失去 了 从 犯错 中 学 习 的 机 会 。 
一 一 备 。 布 业 伯 利 , 《华氏 415 度 》 


十 多 年 前 , Eric Evans 引入 了 领域 驱动 设计 (DDD)。, 在 他 拟 与 的 开创 性 的 图 书 中 ， 
有 一 句 话 手动 了 软件 开发 的 文 柱 。 本 质 上 ， 他 说 的 是 ， 在 设计 系统 时 ， 持 久 化 应 该 
是 架构 师 最 后 关注 的 问题 。 当 然 ， 这 并 不 是 说 它 是 最 不 值得 关注 的 问题 。 本 章 将 从 
这 种 理念 出 发 ， 答 试 解释 现代 Web 应 用 程序 中 的 数据 访问 ， 并 为 有 效 的 应 用 程序 后 
站 开 友 一 个 相对 通用 的 模式 。 持 久 化 显然 是 应 用 程序 后 端的 一 部 分 ， 不 党 想 在 持久 
化 层 之 上 添加 一 个 什么 样 的 抽象 层 ， 持 久 化 层 明 显 由 一 个 在 某 个 持久 化 存储 中 读 写 
数据 的 框 染 构成 ， 并 且 这 个 持久 化 存储 很 可 能 位 于 某 个 云 平 台中 的 远程 服务 右上 。 
越 来 越 多 的 应 用 程序 使 用 NoSQL 存储 ， 不 少 应 用 程序 会 使 用 两 种 不 同 的 堆栈 来 处 
理 数据 : 命令 堆栈 和 查询 堆 栈 。 

讨论 现代 的 ASPNET Core 应 用 程序 中 的 数据 访问 并 不 只 是 向 单 地 介绍 数据 访 
问 库 的 实质 细节 。 本 章 要 传递 的 理念 是 设计 优先 ， 而 不 是 技术 优先 。 因 此 ， 在 DDD 
着 名 的 分 层 染 构 模 式 的 局 发 下 ， 我 们 首先 介绍 用 于 应 用 程序 后 闹 的 一 个 通用 模式 的 
核心 知识 ， 然 后 介绍 在 实际 读 写 应 用 程序 数据 时 可 以 采用 的 数据 访问 选项 。 在 这 个 
方面 ， 我 们 将 介绍 Entity Framework Core 的 关键 功能 。 
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9.1 创建 相对 通用 的 应 用 程序 后 端 


在 建议 的 Layered Architecture 模式 中 ，Evans 再 次 分 机 了 规范 的 三 层 模型 
表示 层 、 业 务 层 和 数据 层 ， 并 引入 了 两 个 关键 的 变化 。 第 一 个 变化 是 他 将 关注 点 放 
到 了 layer 的 概念 上 ,而 不 是 tier。 layer 指 的 是 应 用 程序 组 件 乙 间 的 逻辑 分 隔 , 而 tier 
指 的 是 物理 上 不 同 的 应 用 程序 和 服务 器 。 第 二 个 变化 是 模式 中 识别 的 层 数 不 同 。 分 
层 架 构 基 于 4 个 层 ， 表示 层 、 应 用 层 、 领 域 层 和 基础 结构 层 。 

与 规范 的 三 层 模式 相 比 ， 可 以 看 到 ， 业 务 层 被 分 成 了 两 个 部 分 : 应 用 程序 逻辑 
和 领域 逻辑 ， 数 据 层 则 被 重 命名 为 含义 更 加 广泛 的 基础 结构 层 ( 如 岁 9-1 所 示 )。 


三 层 厚 构 分 层 架 构 ASPNET 应 用 程序 架构 


应 用 工作 流 


持久 化 服务 及 
其 他 服务 


图 9-1 三 层 染 构 与 分 层 染 构 的 对 比 


从 图 中 很 容易 看 出 ASPNET 应 用 程序 的 各 个 部 分 如 何 映射 到 分 层 架构 的 各 层 。 
在 图 9-1 的 层 中 ， 只 有 基础 结构 层 的 组 件 需要 知道 数据 库 的 细节 ， 如 数据 库 的 位 置 
和 连接 字符 串 。 理 想 情况 下 ， 系 统 的 其 余部 分 应 该 被 设计 为 不 知道 持久 化 的 数据 的 
实际 模式 。 最 顶层 的 应 用 程序 层 看 到 的 只 会 是 符合 它们 需要 的 数据 。 因 此 ， 任 何 应 
用 程序 要 想 工作 ， 持 久 化 的 数据 依然 至 关 重 要 ， 但 是 应 用 程序 只 需要 知道 如 何 读 取 和 
写 入 自己 所 需 的 数据 。 读 写 的 细节 能 够 并 且 应 该 被 尽 可 能 地 隐藏 。 


9.1.1 整体 式 应 用 程序 


在 经 典 的 自 底 向 上 设计 ( 几 十 年 来 被 广泛 采用 的 一 种 设计 理念 ) 中 ， 能 够 向 外 界 
证 明 我 们 理解 了 系统 的 第 一 个 成 果 就 是 数据 模型 。 其 他 的 方方面面 都 是 基于 数据 模 
型 的 ， 包 括 过程 以 及 尤为 依赖 数据 模型 的 用 户 界面 和 用 户 体验 。 

在 整体 式 应 用 程序 中 ， 数 据 从 底部 的 持久 化 存储 传递 到 前 端 ， 然 后 再 返回 持久 
化 存储 。 数 据 会 经 过 几 个 转换 点 ， 它 们 会 根据 存储 需要 来 调整 在 用 户 界面 中 收集 的 
数据 ， 也 会 对 后 端 存 储 的 数据 进行 调整 ， 使 其 适合 进行 显示 (参见 图 9-2)。 
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图 9-2 整体 式 应 用 程序 中 的 数据 形式 


从 图 中 很 容易 狂 到 ， 数 据 会 经 过 两 个 不 同 的 路 人 径 : 从 存储 到 前 站 以 及 从 前 病 
回 到 存储 。 我 们 不 应 该 考虑 把 应 用 程序 堆栈 分 成 两 个 部 分 吗 ? 独立 处 理 命 令 堆栈 
和 谈 扒 栈 对 于 开发 来 说 是 不 是 更 加 有 效 ? 这 个 问题 市 来 了 NoSQL 存储 ， 也 使 得 经 典 
RDBMS 系统 开始 文 持 XML 和 JSON。 这 也 正 是 Command and Query Responsibility 
Segregation(CQRS) 模 式 的 作用 。 对 于 理想 情况 下 以 一 种 方式 存储 数据 ， 而 以 男 一 种 方 
式 谈 取 数据 的 丰 实 场景 来 说 ， 将 命令 堆栈 和 查询 堆 栈 分 隅 开 古 更 有 效 的 信友 。 

虽然 分 层 染 构 中 并 非 必 须 使 用 CQRS， 但 是 当 结 合 了 CQRS 时 ， 分 层 架 构 束 提供 
本 一 个 设计 的 起 点 ， 很 可 能 是 最 适合 如 今 的 大 部 分 场景 的 选项 (如 图 9-3 所 示 )。 


基础 结构 


基础 结构 


me ™ EE Es ee es i ys 
Ws ms 


me 
a 


mm er 
本 
EE sy 


主 数据 源 |---- 同步。 ------ 
图 9-3 ”结合 了 CQRS 设计 的 分 层 架构 模式 
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9.1.2 CQRS 方法 


一 旦 思想 上 接受 了 有 两 个 不 同 的 堆栈 (一 个 用 于 读 应 用 程序 的 状态 ， 一 个 用 于 
更 新 应 用 程序 的 状态 )， 许 多 潜在 的 实现 场景 就 会 浮现 出 来 。 没 有 哪 种 场景 是 适合 
所 有 人 的 。 这 里 没有 放 之 四 海 而 皆 准 的 模式 , 但 是 CQRS 的 一 般 思 想 能 够 让 每 个 
人 受益 。 

有 经 验 的 开发 人 员 会 记得 ， 创 建 出 一 个 理想 的 数据 模型 并 使 其 能 够 将 关系 数据 
模型 的 原则 和 最 终 用 户 实际 需要 的 视图 的 复杂 性 结合 起 来 是 一 项 多 么 困难 的 工作 。 
如 果 只 有 一 个 应 用 程序 堆栈 ， 就 只 能 有 一 个 面向 持久 化 的 数据 模型 ， 但 是 需要 调整 
这 个 模型 ,使 其 能 够 有 效 地 满足 前 端的 需要 。 特别 是 与 某 种 方法 学 (如 领域 驱动 设计 ) 
的 额外 的 抽象 层 结合 起 来 时 ， 后 端 (业务 逻辑 和 数据 访问 逻辑 ) 的 设计 很 容易 变 得 一 
团 乱 。 

在 这 个 方面 ，CQRS 通过 将 设计 问题 分 解 为 两 个 较 小 的 问题 ， 并 帮助 找到 每 个 
问题 的 正确 设计 方案 ， 而 不 施加 外 部 约束 ， 使 得 设计 变 得 更 加 简单 。 这 是 新 的 应 用 
程序 架构 设想 的 显现 。 具 有 不 同 的 堆栈 的 好 处 是 ， 很 容易 为 实现 命令 和 查询 使 用 不 
同 的 对 象 模型 。 如 有 必要 ， 可 以 为 命令 使 用 一 个 完整 的 领域 模型 ， 而 为 表示 使 用 一 
个 定制 的 普通 数据 传输 对 象 ， 可 能 这 些 对 象 是 从 SQL 查询 具体 化 的 。 另 外 ， 当 需要 
多 个 表示 前 端 (如 Web、 移 动 Web 和 移动 应 用 ) 时 ， 只 需要 额外 创建 读 模 型 。 整 体 复 
杂 度 是 个 体 复杂 度 的 和 ， 而 不 是 笛 卡 尔 积 。 图 9-3 要 表达 的 就 是 这 一 点 。 


1. 使 用 不 同 的 数据 库 


将 后 端 分 解 成 不 同 的 堆栈 使 设计 和 编码 变 得 简单 ， 并 提供 了 前 所 未 有 的 扩展 能 
力 。 与 此 同时 ， 这 种 方法 也 提出 了 一 些 问题 ， 需 要 在 架构 级 别 仔细 考量 。 如 何 使 两 
个 堆栈 保持 同步 , 使 数据 命令 写 入 能 够 被 一 致 地 读 回 ?取决 于 想 要 解决 的 业务 问题 ， 
CQRS 实现 可 以 基于 一 种 或 两 种 数据 库 。 如 果 使 用 了 一 个 共享 数据 库 ， 那 么 要 为 查 
询 目 的 获取 正确 的 数据 投影 , 只 需要 在 读 堆 栈 中 的 普通 查询 之 上 做 一 些 额 外 的 工作 。 
与 此 同时 ， 共 享 数据 库 确 保 了 经 典 的 ACID 一 致 性 。 

全 于 性 能 或 可 扩展 性 ， 可 以 考虑 为 命令 堆栈 和 读 堆 栈 使 用 不 同 的 持久 化 端点 。 
例如 ， 命 令 堆 栈 可 能 有 一 个 事件 存储 、 一 个 NoSQL 文档 存储 ， 可 能 还 有 一 个 非 持 
久 的 存储 (如 内 存 缓存 )。 命 令 数据 与 读数 据 的 同步 可 能 是 异步 发 生 的 ， 甚 至 可 以 根 
据 过 期 数据 (以 及 数据 的 过 期 程度 ) 对 表示 的 影响 来 调度 同步 操作 ， 使 其 定时 进行 。 
当 使 用 了 不 同 的 数据 库 时 ， 读 数据 库 币 笛 是 一 个 普通 的 关系 数据 库 ， 只 是 提供 了 数 
据 的 一 个 (或 多 个 ) 投 影 ， 如 图 9-4 所 示 。 
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9-4 ”为 命令 堆栈 和 查询 堆栈 使 用 共享 数据 库 和 独立 数据 库 时 的 CQRS 架构 的 对 比 
2. 什么 时 候 适 合 使 用 CQRS 


CQRS 并 不 是 用 于 企业 级 系统 设计 的 一 种 全 面 的 方法 。 它 只是 一 种 模式 ， 指 导 
我 们 为 一 个 可 能 很 大 的 系统 架构 一 个 具体 的 、 有 界 的 上 下 文 。CQRS 架构 模式 主要 
被 设计 用 来 解决 局 并 友 业 务 场 景 中 的 性 能 问题 ， 在 这 类 场景 中 ， 同 步 处 理 命令 并 执 
行 数据 分 析 的 问题 变 得 越 来 越 多 。 许多 人 似乎 认为 ， 离开 了 这 种 协作 式 系 统 ,， CQRS 
的 效果 束 会 显 乔 降低。 事实 上 ，CQRS 的 效果 之 所 以 在 协作 式 系 统 中 办 浴 ， 古 因为 
它 允 许 以 平滑 得 多 的 方式 来 处 理 复 末 性 和 耽 争 的 资源 。 我 认为 ， 它 还 有 很 多 作用 并 
个 是 一 眼 束 能 看 到 的 。 

即使 在 简单 得 多 的 场景 中 ， 碍 询 堆栈 与 命令 堆栈 的 分 隔 简化 了 议 计 并 大 大 降低 
了 友 生 错误 的 风险 ，CQRS 也 足以 为 使 用 如 构 买单 。 换 名 话说 ，CQRS 降低 了 实现 
一 个 系统 甚 全 是 一 个 复杂 的 系统 押 需 要 的 技能 水 平 。 使 用 CQRS 使 得 几乎 任何 团队 
都 有 能 力 在 可 扩展 性 和 代码 整洁 性 方面 做 得 很 好 。 


、， -二 
二 = ) 土 是 : 


使 用 CQRS， 并 且 堆 栈 之 间 整 洁 地 、 彻 底 地 分 隔 开 ( 例 如 使 用 不 同 的 数据 库 )， 
为 使 用 事件 作为 主要 数据 源 铺 平 了 道路 。 使 用 事件 作为 主要 数据 源 意味 着 命令 堆栈 
只 是 记录 发 生 了 什么 (例如 系统 中 新 添加 了 一 个 客户 )， 而 不 一 定 更 新 当前 的 客户 列 
表 。 获 取 最 新 的 客户 列表 是 读 堆 栈 的 职责 ， 为 了 保护 性 能 ， 还 可 以 添加 带 外 同步 ， 
使 得 记录 下 的 每 个 事件 都 会 触发 读 堆 栈 进行 更 新 ， 从 而 使 得 对 于 应 用 程序 而 言 不 可 
缺少 的 所 有 数据 快照 都 保持 最 新 。 


9.1.3 基础 结构 层 的 构成 


在 一 个 真实 的 应 用 程序 后 端 中 ， 基 础 结构 层 是 与 使 用 具体 的 技术 相关 的 所 有 东 
西 ， 包括 数据 持久 化 (O/RM 框架 ， 如 Entity Framework)、 外 部 Web 服务 、 特 定 的 安 
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全 API、 日 志 记 录 、 跟 踩 、IoC 容 右 、 缓 存 等 。 基 础 结构 层 中 最 突出 的 组 件 是 持久 
化 屋 ， 其 实 也 就 是 原来 的 数据 访问 屋 ， 只 不 过 可 能 经 过 扩展 , 包含 了 更 多 的 数据 源 ， 
而 不 只 是 普通 的 关系 数据 存储 。 持久 化 层 知道 如 何 读 和 /或 写 数据 ， 它 是 由 存储 库 类 
构成 的 。 


1. 持久 化 层 


如 有 果 采 用 经 典 的 存储 系统 当前 状态 的 方法 ， 那 么 对 于 每 个 相关 的 实体 组 ， 都 会 有 
一 个 存储 库 类 。 上 所 谓 的 实体 组 ， 指 的 是 总 是 在 一 起 出 现 的 实体 ， 例 如 订单 和 订单 项 。 
这 个 概念 在 DDD 中 称 为 “聚合 ”。 存 储 库 的 结构 可 以 类 似 于 CRUD， 即 对 于 泛 型 类 
型 T， 有 Save、Delete 和 Get 方法 ， 而 且 使 用 谓词 来 租 询 数据 的 专门 部 分 。 不 过 ， 也 
不 是 不 能 让 存储 库 具 有 RPC 风格 ， 使 其 方法 所 代表 的 操作 一 谈 、 与 或 插入 一 一 满 
足 业 务 目 的 。 我 通 币 把 这 一 点 总 结 为 : 没有 哪 种 编写 存储 库 的 方式 是 销 误 的 。 


2. 缓存 层 


系统 中 并 不 是 所 有 的 数据 都 以 相同 的 速率 变化 。 因 此 ， 每 当 收 到 请 求 时 ， 让 数 
据 库 服务 费 读 取 没 有 发 生变 化 的 数据 其 实 并 不 合理 。 而 男 一 方 和 面 ， 在 Web 应 用 程序 
中 , 请 求 是 并 发 传 入 的 。 每 秒 可 能 有 许多 请 求 到 达 Web 服务 占 , 并 且 在 并 发 请 求 中 ， 
许多 可 能 在 请 求 同 一 个 页 面 。 那 么 ， 为 什么 不 缓存 该 页 面 ， 或 者 至 少 缓存 该 页 面 使 
用 的 数据 呢 ? 

尽管 在 没有 缓存 的 情况 下 ， 所 有 的 系统 都 应 该 能 够 工作 ， 但 是 实际 上 ， 在 没有 
数据 绥 存 的 情况 下 ， 极 少 应 用 程序 能 够 坚持 一 两 秒 。 在 局 流量 网 站 上 ， 一 两 秒 能 够 
产生 巨大 的 影响 。 在 许多 情况 下 ， 绥 存 已 经 成 为 构建 在 专用 框架 上 的 附加 层 ， 这 些 
专用 框架 实际 上 是 内 存 数据 库 ， 如 Memcached、ScaleOut 或 NCache。 但 是 ， 内 存 
解决 方案 也 并 不 是 没有 问题 ， 因 为 对 于 生存 期 较 长 的 二 代 对 象 ， 它 们 可 能 触发 频繁 
而 耗 时 较 长 的 垃圾 回收 操作 。 在 边缘 案例 中 ， 这 可 能 导致 超时 。 

3. 外 部 服务 

基础 结构 层 的 另外 一 个 场景 是 只 能 通过 Web 服务 访问 数据 。 这 种 场景 的 例子 包 
括 Web 应 用 程序 位 于 某 个 CRM 软件 之 上 ， 或 者 必须 使 用 某 个 公司 的 专利 服务 。 一 
般 来 说 ， 基 础 结构 层 负 员 根 据 需 要 封 产 外 部 服务 。 从 架构 的 角度 来 讲 ， 如 今 我 们 的 
思维 方式 应 该 是 考虑 基础 结构 层 ， 而 不 是 封 狼 了 关系 数据 库 的 普通 数据 访问 层 。 


9.2 .NET Core 中 的 数据 访问 


要 在 ASPNET Core 应 用 程序 中 访问 数据 ， 前 先 想到 的 选项 第 第 是 使 用 Entity 
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Framework Core(EF Core)。EF Core 是 新 面孔 ， 是 在 规范 的 Entity Framework 6.x 的 
基础 上 专门 设计 的 ， 为 开 友 人 员 提 供 了 一 个 主要 的 O/RM 选项 。 本 章 剩 余部 分 将 介 
绍 使 用 EF Core 来 执行 的 基本 的 、 最 钊 见 的 任务 。 但 是 ， 在 那 之 前 ， 有 必要 笛 单 了 
解 一 下 其 他 数据 访问 选项 。 你 会 惊讶 地 发 现 ， 原 来 有 这 么 多 选项 可 用 。 


9.2.1 Entity Framework 6.X 


Entity Framework 6.x(EF6) 是 老 版 本 的 O/RM 框架 ， 我们 在 .NET 应 用 程序 中 多 
年 来 都 使 用 它 编写 数据 访问 任务 。EF6 只 与 新 的 .NET Core 平台 部 分 兼容 。 换 人 句 话 
说 , 可 以 在 .NET Core 项 目 中 使 用 EF6, 但 是 这 要 求 必 须 针 对 完整 的 .NET Framework 
来 编译 .NET Core 代码 ,问题 在 于 ,EF6 并 不 能 完全 文 持 .NET Core。 因 此 ,在 ASPNET 
Core 应 用 程序 中 使 用 EF6 时 ,并 不 能 获得 里 平 台 功 能 。 针对 完整 的 .NET Framework 
编译 的 ASPNET Core 应 用 程序 (可 能 重用 了 一 些 现 有 的 EF6 代码 ) 只 能 运行 在 
Windows 上 。 


注意 : 

当 运 行 在 Windows 上 时 ， 可 以 在 IIS 中 托管 ASPNET Core 应 用 程序 ， 也 可 以 
在 Windows 服务 中 托管 并 使 其 运行 在 Kestrel 上 . 虽然 这 么 做 失去 了 IIS 的 更 高 级 的 
服务 ， 但 是 却 非 常 高 效 。 不 过 ， 田 一 方面 ， 并 非 始 终 需 要 那些 服务 。 所 以 ， 这 依然 
是 一 个 需要 权衡 利 兰 的 决定 。 


1. 将 EF6 代码 封装 到 独立 的 类 库 中 


在 ASPNET Core 应 用 程序 中 使 用 EF6 的 推荐 方法 是 ， 将 所 有 的 类 (包括 DB 上 
下 文 和 实体 类 ) 放 到 一 个 独立 的 类 库 项 目 中 ， 使 其 基于 完整 的 框架 。 然 后 ， 在 新 的 
ASPNET Core 项 目 中 添加 对 前 一 个 项 目的 引用 。 必 须 执 行 这 个 额外 的 步 又 ， 因 为 
ASPNET Core 项 目 并 不 文 持 EF6 上 下 文 类 中 能 够 通过 代 人 码 触 友 的 全 部 功能 。 因 此 ， 
并 不 文 持 在 ASPNET Core 项 目 中 和 直接 使 用 EF6 上 下 文 类 。 


从 现实 的 角度 讲 , 使 用 中 间 类 库 并 不 是 一 种 局 限 。 事实 上 , 在 ASPNET Core( 或 
者 只 是 .NET Core) 项 目 中 使 用 EF6 的 主要 目的 是 重用 现 有 的 代码 ， 而 不 是 使 用 熟悉 
的 老 API。 现 有 的 代码 很 有 可 能 已 经 被 隔离 到 一 个 独立 的 类 库 中 。 但 是 ， 即 使 要 编 
写 新 的 EF6 代码 ， 使 其 与 项 目 主体 隔离 开 也 是 一 个 很 好 的 设计 决定 ， 能 够 便于 在 将 
来 替换 数据 访问 框架 ， 使 用 一 个 完全 支持 的 跨 平 台 框 架 API( 如 EF Core) 或 者 本 章 支 
持 的 其 他 选项 。 
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2. 获取 连接 字符 串 


EF6 上 下 文 类 获取 连接 字符 串 的 方式 与 ASPNET Core 中 最 新 的 、 完 全 重 写 的 
配置 层 并 不 完全 兼容 。 考 虑 下 面 的 常见 代码 段 。 


public class MyOwnDatabase : DbContext 


{ 
public MyownDatabase (strIng connSstringOrDbName = "name~=~MyOwnDatabase") 
: base (connstringOorDbName) 
{ 
} 
} 


应 用 程序 特定 的 DbContext 关 通 过 参数 接受 连接 字符 串 ， 或 者 从 web.config 文 
件 中 获取 连接 字符 串 。 在 ASPNET Core 中 ， 并 没有 web.config 文件 ， 所 以 连接 字 
从 串 要 么 是 一 个 常量 ， 要 么 应 该 从 .NET Core 配置 层 谈 取 并 传 入 。 


3. 将 EF 上 下 文 与 ASP.NET Core DI 集成 


在 网 上 可 以 找到 的 大 部 分 ASPNET Core 数据 访问 示例 展示 了 如 何 通过 依赖 注 
入 (DD, 将 DB 上 下 文 注 入 应 用 程序 的 所 有 层 中 。 在 DI 系统 中 注入 EF6 上 下 文 的 方 
式 与 注入 其 他 服务 相同 。 理 想 的 作用 域 是 每 个 请 求 ， 这 意味 看 同一 个 HITP 请 求 内 
的 所 有 调用 方 会 共享 同一 个 实例 。 


Public void ConfigureServices (IServiceCollection services) 
{ 


// Other services added here 


// Get connection string from confiqguration 
Var CONNStTIrinNnG = ...} 


SEILVvices. ee => new MyOwnDatabase (connstring)); 


} 


添加 了 上 睾 的 配置 后 ， 现 在 甚至 可 以 将 EF6 DB 上 下 文 直接 注入 控制 器 或 存储 
库 类 (这 种 情况 更 有 可 能 出 现 ) 中 。 
public class SomeController : Controller 


{ 


private readonly MyOwnDatabase context; 


public SomeController (MyOwnDatabase context) 
{ 
Context = context} 


} 


// More code here 
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上 面 的 代码 段 将 一 个 DB 上 下 文 注 入 一 个 控制 器 类 中 ， ei 
第 见 ， 但 是 我 不 建议 你 这 么 做 ， 理 由 很 笛 单 : 这 会 导致 控制 闫 变 得 腑 肿 ， 并 且 会 
ie rc Oper td encehdpernygpte sient i 
用 DI 模式 ,或 者 根本 不 为 DB 上 下 文 类 使 用 DI 模式 。 


9.2.2 ADO.NET 适 本 疾 


在 ASPNET Core 2.0 中 ，Microsoft 又 重新 引入 了 原来 的 ADO.NET API 的 一 些 
组 件 ， 具 体 来 说 包括 DataTable 对 象 、 数 据 谈 取 器 和 数据 适配器 。 虽 然 ADO.NET 
经 典 API 始终 是 .NET Framework 的 组 成 部 分 , 但 是 近年 来 ， 它 在 被 一 步 步 放 弃 ， 狐 
开发 的 应 用 程序 更 偏 问 于 使 用 Entity Framework。 因 此 ， 在 设计 .NET Core API 1.x 
时 ，ADO.NET 经 典 API 成 为 牺牲 品 ， 但 是 由 于 呼声 很 高 ， 在 .NET Core API 2.0 版 
本 中 ， 又 重新 把 它 引 入 进来 。 因 此 ， 在 ASPNET 2.0 应 用 程序 中 ， 可 以 编写 数据 访 
问 代 人 码 来 管理 连接 、SQL 命令 和 游标 ， 束 像 在 刚 进 入 .NET 时 代 时 那样 。 


1. 发 出 SQL 命令 


在 ASPNET Core 中 ，ADONET API 的 编程 接口 几乎 与 在 完整 的 NET Framework 
中 完全 一 梓 ， 而 且 编 程 范 式 也 是 相同 的 。 首 先 也 是 最 重要 的 ， 通 过 编程 来 管理 数 
据 库 连 接 并 创建 命令 及 其 参数 ， 可 以 获得 对 每 条 命令 的 完全 控制 。 下 面 给 出 了 一 
个 例子 : 


Var conn = new SqlConnection(}); 
conn.ConnectionSstring = ” 
Var cmd = new SgqlCommand ("SELECT * FROM customers", conn); 


;准备 怠 络 后 ， 必 须 通 过 一 个 打开 的 连接 来 友 出 命令 。 为 此 ， 需 要 再 添加 几 行 代码 。 


conn.Open () 
Var reader = cmaQ .ExecuteReaaeTr (CommanaBehavIor .CloseConmnect1Ionm) ， 


// Read data and do any required processing 

te 

由 于 在 打开 数据 读 取 右 的 时 候 会 请 求 关闭 连接 的 行为 ， 因 此 在 关闭 读 取 占 时 ， 
连接 将 目 动 天 闭 。SqlCommand 类 的 几 个 方法 能 够 执行 命令 ， 如 表 9-1 所 示 。 

表 9-1 SqglCommand 类 的 执行 方法 
执行 方法 描述 
ExecuteNonQuery 执行 命令 ， 但 不 返回 值 。 特 别 运用 于 非得 询 
语句 ， 如 UPDATE 
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执行 方法 摘 述 
ExecuteReader 执行 命令 ， 并 返回 一 个 指向 输出 流 的 开始 位 
置 的 话 标 。 特 别 适 用 于 碍 询 命令 
ExecuteScalar 执行 命令 ， 并 返回 单个 但 。 特 别 运用 于 返回 
一 个 标量 值 的 查询 命令 ,如 MAX 或 COUNT 
ExecuteXmlReader 执行 命令 ， 并 返回 一 个 XML 谍 取 器 。 特 别 
适用 于 返回 XML 内 容 的 命令 


表 9-1 中 的 方法 提供 了 多 种 选项 ,可 用 来 获取 想 要 执行 的 任何 SQL 语句 或 存储 
过 程 的 结果 。 下 向 的 例子 显示 了 如 何 授 历 一 个 数据 读 取 费 的 记录 。 


Var reader = cmd.ExecuteReader(CommandBehavior.CloseConnection),;) 
while (reader.Read()) 
{ 
var column0 = reader[0]; // returns an Object 
Var Columnl = reader.GetSstring (1) // index of the column to read 


// Do something with data 
} 


reader.Close ();} 


二 】 注意 
.NET Core 中 的 ADO.NET API 与 NET Framework 中 的 API 相同 ， 不 支持 SQL 
Server 领域 近期 的 发 展 ， 如 SQL Server 2016 及 更 新 版 本 中 对 JSON 的 原生 支持 。 例 
如 ， 没 有 ExecuteJsonReader 这 样 的 方法 将 JSON 数据 解析 为 一 个 类 . 


2. 将 数据 加 载 到 已 断 开 连 接 的 容器 


如 果 和 需要 处 理 一 个 很 长 的 啊 应 ， 同 时 使 占用 的 内 存量 最 少 ， 那 么 特别 适合 使 用 
恋 取 占 。 如 果 是 其 他 情况 , 更 好 的 方法 是 将 合 询 结果 加 载 到 一 个 已 断 开 连 接 的 容 占 ， 
如 DataTable 对 象 。 有 几 种 方法 用 于 此 目的 。 

CoOnn .OPen () 

Var reader = cmd.ExecuteReader (CommandBRBehavior.CloseConnection),; 

Var table = new DataTable("Customers™");} 

table.Ccolumns.Add("FirstName™); 

table.Ccolumns.Add("LastName™);} 

table.columns.Add ("CountryCode™)}); 

table.Load (reader); 

reader.Close (});} 

DataTable 对 象 是 具有 架构 、 关 系 和 主键 的 数据 库 表 的 内 存 版 本 。 要 填充 一 个 
DataTable 对 象 ， 最 简单 的 方法 是 获取 一 个 数据 读 取 占 游 标 ， 并 加 载 声 明 的 列 中 的 所 
有 内 容 。 了 映射 是 按照 列 索引 进行 的 ，Load 方法 背后 的 实际 代码 非 常 接 近 朋 耐看 到 的 
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循环 。 开 及 人 员 具 需要 使 用 一 个 方法 ， 但 是 仍然 需要 负 贡 管理 数据 库 连 接 的 状态 。 
因此 ， 一 般 来 说 ， 可 以 采取 的 最 安全 的 方法 是 使 用 Dispose 模式 ， 在 C# using 语句 
中 创建 数据 库 连接 。 


3. 通过 适配器 获取 数据 


要 将 数据 加 载 到 内 存 容 右 ， 最 简洁 的 方式 是 使 用 数据 适 配 硕 。 数 据 适 配 右 是 一 
个 汇总 了 整个 查询 过 程 的 组 件 ， 由 一 个 命令 对 象 或 select 命令 文本 以 及 一 个 连接 对 
象 构 成 。 数 据 适 配 问 帮助 打开 和 关闭 连接 ， 并 将 得 询 的 所 有 结 采 (包括 多 个 结 采 集 ) 
打包 到 一 个 DataTable 或 DataSet 对 象 中 (DataSet 是 DataTable 对 象 的 一 个 集合 )。 

Var conn = new SqlConnection(}); 

conn.ConnectionSstring = "... 

Var cmd = new SqlCommand (SELECT * FROM CUstomeTrs conn);} 

Var table = new DataTable().;，} 


Var adapter = new SqlDataAdapter (cmd); 
adapter.Fill (table); 


如 果 熟 悉 ADO.NET API, 会 发 现 .NET 和 ASPNET Core 2.0 中 的 它 与 原来 一 样 。 
这 保证 了 又 有 一 部 分 遗留 代码 可 以 移植 到 其 他 平台 。 除 此 以 外 ， 对 ADO.NET 的 文 
持 又 为 在 NET Core 和 ASPNET Core 中 使 用 SQL Server 2016 的 较 融 级 功能 (例如 
JSON 支持 和 更 新 历史 ) 提 供 了 一 个 机 会 。 事 实 上 ， 对 于 这 类 功能 ，EF6 和 EF Core 
没有 提供 专门 的 文 持 。 


9.2.3 ”使 用 微型 O/RM 框架 


O/RM 框架 得 询 数 据 行 并 把 它们 映射 到 一 个 内 存 对 象 的 属性 。 相 比 前 面 讨 论 的 
DataTable 对 象 ，O/RM 将 相同 的 低级 数据 加 载 到 一 个 强 类 型 类 中 ， 而 不 是 一 个 通用 
的 、 面 癌 表 的 容器 中 。 提 到 .NET Framework 中 的 O/RM 框架 ， 大 部 分 开发 人 员 会 想 
到 Entity Framework 或 NHibernate。 它 们 是 最 流行 的 框架 ， 但 也 是 最 庞大 的 框架 。 
对 于 OARM 框架 来 说 ,“ 庞 大 ”意味 着 文 持 的 功能 多 一 一 从 映射 功能 到 缓存 功能 ， 
从 事务 性 到 并 及 性 ， 都 可 能 文 持 。 对 于 用 于 .NET 的 现代 O/RM 来 说 ,， 文 持 LINQ 得 
询 语 法 至 关 重 要 。 而 文 持 LINQ 查询 语法 ， 就 需要 文 持 许多 功能 ， 从 而 不 可 避免 地 
影响 到 单独 操作 的 内 存 占用 量 ， 甚 至 性 能 。 因 此 ， 有 些 人 和 有 些 公司 近来 开始 使 用 
微型 O/RM 框架 。 对 于 ASPNET Core 应 用 程序 来 说 ， 存 在 一 些 选项 。 


1. 微型 O/RM 与 完整 O/RM 的 对 比 


事实 上 ， 微 型 O/RM 完成 的 基本 工作 与 完整 O/RM 相同 ， 而 大 部 分 时 候 ， 我 们 
并 不 需要 使 用 一 个 功能 完善 的 O/RM。Stack Overflow 驶 是 一 个 很 好 的 例子 。 这 是 流 
量 最 高 的 网 站 之 一 ， 但 它 没有 使 用 完整 ORM。 甚 至 出 于 性 能 原因 ，Stack Overflow 
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还 创建 了 目 己 的 微型 ORM。 尽 管 如 此 ， 我 个 人 的 观点 是 ， 大 部 分 应 用 程序 之 所 以 
使 用 Entity Framework， 只 是 因为 这 是 .NET Framework 框架 的 一 部 分 ， 使 得 编写 得 
询 成 为 编写 C# 代 人 码 ， 而 不 是 SQL 语句 。 生 产 效 率 很 重要 。 一 般 来 说 ， 我 倾 回 于 认 
为 使 用 完整 O/RM 是 生产 效率 更 局 的 选择 ， 因 为 其 中 存在 大 量 示 例 和 功能 ， 包 括 对 
命令 进行 内 部 优化 ， 以 保证 任何 时 候 都 能 做 到 合理 取舍 。 

微型 O/RM 占用 的 内 存量 之 所 以 小 ， 是 因为 提供 的 功能 少 。 问 题 在 于 ， 和 人 微型 
O/RM 缺少 的 功能 是 否 会 对 应 用 程序 造成 影响 。 缺 少 的 主要 功能 是 二 级 缓存 和 对 关 
系 的 内 置 文 持 。 二 级 绥 存 指 的 是 框 潍 管理 看 额外 的 一 层 缓存 ， 负 责 在 配置 的 一 定时 
间 内 持久 化 多 个 连接 和 事务 的 结果 。NHibernate 支持 二 级 缓存 ， 但 是 Entity 
Framework 个 文 持 (不 过 借助 一 些 迁 回 的 方法 能 在 EF6 中 实现 这 种 效果 ， 而 对 于 EF 
Core， 则 有 一 个 扩展 项 目 )。 这 意味 看 二 级 绥 存 并 不 是 区 分 微型 O/RM 框架 和 完整 
O/RM 框 染 的 重要 因 桑 。 男 外 一 个 缺少 的 功能 则 更 加 重要 ， 即 对 关系 的 文 持 。 

编写 但 询 时 (假设 在 EF 中 编 与 )， 可 以 在 得 询 中 包含 任何 外 键 关 系 ， 而 不 考虑 基 
数 。 将 但 询 结 果 扩 展 到 连接 表 是 语法 的 组 成 部 分 ， 并 不 需要 使 用 一 种 不 同 的 、 更 加 
清晰 的 语法 来 构建 租 询 。 微 型 O/RM 通常 不 能 提供 这 种 能 力 。 在 微型 ORM 中 ， 残 
需要 在 这 个 时 候 做 出 取舍 。 可 以 投入 更 多 时 间 ， 编 与 需要 更 遍 级 的 SQL 技能 的 复杂 
人 查询， 以 此 为 代价 来 获得 更 快 的 操作 性 能 。 男 一 方面 ， 可 以 跳 过 需要 SQL 技能 的 部 
分 ， 让 系统 蔡 你 完成 相关 工作 。 如 果 利 用 系统 提供 的 这 种 额外 的 服务 ， 代 价 束 是 占 
用 的 内 存量 更 大 ， 整 体 性 能 会 降低 。 

另外 ,完整 O/RM 还 可 以 提供 设计 器 和 /或 迁移 功能 ， 这 使 它 显 得 更 加 庞大 ， 但 
是 并 不 是 每 个 人 都 喜欢 或 者 使 用 这 些 功 能 。 


2. 微型 O/RM 示例 


Stack Overflow 团队 选择 创建 定制 的 微型 ORM， 即 Dapper 框架 ， 他 们 目 己 编 
写 优 化 程度 极 高 的 SQL 答 询 并 目 己 添加 大 量 外 部 缓存 层 。 通 过 http://github.com/ 
StackExchange/Dapper 可 以 访问 Dapper 框 名 。 访 框架 特别 擅长 对 SQL 数据 库 执 行 
SELECT 语句 ， 并 将 返回 的 数据 映射 到 对 和 象 。 其 性 能 接近 于 使 用 数据 读 取 器 ， 即 
在 .NET 中 查询 数据 的 最 快 的 方式 ， 但 是 它 可 以 返回 一 个 内 存 对 和 象 的 列表 。 
Var customer = connection.Query<Customer> | 
"SELECT * FROM customers WHERE Id = @Id"™, 
new { Id = 123 | ) 7; 
NPoco Framework 玉 用 了 相同 的 指导 原则 , 其 至 代 公 与 Dapper 也 只 有 极 小 的 区 
别 。 通 过 http://github.com/schotime/npoco 可 以 访问 NPoco 框架 。 
using (IDatabase db = new Database("connection string")) 
{ 
Var customers = ab.Eetch<CustomeLr> (SELECT * FROM customers™); 


} 
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微型 O/RM 的 数量 每 天 都 在 增长 ， 对 于 ASPNET Core 还 有 其 他 微型 O/RM 可 用 ， 
Ul Insight.DatabaseChttp:/Wgithub.conyjonwasnerInsight.Database) 和 PetaPoco(http://Wwww. 
toptensoftware.com/petapoco)， 后 者 作为 一 个 大 文件 提供 ， 可 和 集成 到 应 用 程序 中 。 

但 是 ， 关 于 微型 O/RM 的 天 键 点 并 不 是 应 该 使 用 哪 一 个 做 型 ORM， 而 是 是 个 
应 该 使 用 微型 ORM， 而 非 完 整 O/RM。 


注意 : 
根据 Stack Overflow 的 工程 师 在 Dapper 主页 http://github.conyStackExchange/ 
DappenD 上 发 布 的 数据 ， 就 性 能 而 言 ， 对 于 单个 查询 ，Dapper 比 Entity Framework 最 
多 快 10 倍 。 这 是 巨大 的 差别 ， 但 是 不 一 定 足 以 让 每 个 人 决定 使 用 Dapper 或 另外 一 
个 微型 O/RM. 这 个 决定 要 取决 于 运行 的 查询 的 数量 , 以 及 编写 查询 的 开发 人 员 的 
技能 水 平 ， 还 有 就 是 可 以 用 来 提升 性 能 的 备 选 方案 . 


9.2.4 使 用 NoSQL 存储 


术语 NoSQL 有 多 种 含义 ， 可 指 代 许 多 不 同 的 产品 。 但 是 ， 最 终 可 以 把 NoSQL 
总 结 如 下 : 当 不 想 要 或 者 不 需要 关系 存储 时 ，NoSQL 是 首选 的 数据 存储 范式 。 一般 
来 说 ， 只 有 在 一 种 情况 中 会 真正 想 要 使 用 NoSQL 存储 : 当 记 录 的 模式 有 变化 ， 但 
是 记录 在 逻辑 上 彼此 关联 时 。 

考虑 这 种 场景 在 一 个 多 租户 应 用 程序 中 ， 需 要 填写 并 存储 一 个 表单 或 问卷 。 
每 个 租户 都 可 以 有 自己 的 字段 列表 ， 而 我 们 需要 保存 多 个 用 户 的 值 。 每 个 租户 的 表 
单 可 能 是 不 同 的 ， 但 是 得 到 的 记录 在 逻辑 上 是 相关 联 的 ， 理 想 情 况 下 应 该 保存 到 同 
一 个 存储 中 。 在 关系 数据 库 中 ， 并 没有 多 少 选 项 可 用 ， 只 能 创建 一 个 模式 ， 让 这 个 
模式 是 所 有 潜在 字段 的 联合 。 但是， 即使 是 这 样 ， 要 为 某 个 租户 添加 一 个 新 字段 时 ， 
也 需要 修改 表 的 模式 。 按 行 而 不 是 按 列 组 织 数据 引发 了 其 他 问题 ， 例 如 每 当 某 个 租 
户 的 查询 超出 了 SQL 页 和 面 大 小 时 , 就 会 对 性 能 造成 冲击 。 虽然 情 况 会 随 看 具体 的 应 
用 程序 使 用 而 有 不 同 ， 但 是 事实 是 ， 无 模式 的 数据 并 不 适合 使 用 关系 存储 。NoSQL 
存储 在 这 种 场景 中 可 以 一 展 所 长 。 

如 前 所 述 ，NoSQL 存储 有 多 种 分 类 方式 。 在 本 书 中 ,我 倾向 于 简单 地 把 它们 分 
为 物理 存储 和 内 存 存储 。 虽 然 做 出 了 这 种 区 分 ， 但 是 二 者 之 间 的 区 别 其 实 很 小 。 
NoSQL 存储 主要 用 作 一 种 缓存 形式 , 不 常用 作 主 数据 存储 。 当 它们 确实 被 用 作 主 炎 
据 存 储 时 ， 通 常 是 因为 应 用 程序 具有 事件 济源 架构 。 


1. 经 典 的 物理 存储 


物理 NoSQL 存储 是 一 种 无 模式 数据 库 ， 它 将 .NET Core 对 象 存储 到 磁盘 上 ， 并 
提供 了 获取 和 往 选 .NET Core 对象 的 功能 . MongoDB 可 能 是 最 流行 的 NoSQL 存储 ， 
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同时 还 有 Microsoft 的 Azure DocumentDB。 有 总 思 的 是 ， 使 用 MongoDB API 的 应 
用 程序 上 只 需要 修改 连接 字符 串 ， 就 可 以 改 为 写 入 DocumentDB 数据 库 。 下 面 是 针对 
DocmentDB 的 一 个 得 询 示 例 。 

Var client = new DocumentClient (azureEncpolntUTr1I，PassworQ) : 

Var requestUri = UriFactory.CreateDocumentCollectionUri ("MyDB", "questionnaire— 

items™"); 

Var Gquestionnajre = client.cCcreateDocumentQuery<Questionnalre> (requestUr1i) 
-Where (gq => gd.1Id == "tenant—12345™" && qd => 9q.Year = 2018) 
.ASsEnumerable () 

.FirstorDefault()}); 


NoSQL 存储 的 主要 好 处 在 于 能 够 存储 结构 不 同 但 是 彼此 相关 的 数据 , 能 够 扩展 
存储 , 并 月 得 询 使 用 起 来 很 容易 。 其 他 物理 NoSQL 数据 库 还 包括 RavenDB、CouchDB 
和 CouchBase， 后 者 特别 适用 于 移动 应 用 程序 。 


2. 内 存 存 储 


内 存 存 储 本 质 上 就 是 用 作 键 - 值 字 典 的 大 缓存 应 用 程序 。 尽 管 它 们 确实 备份 内 
容 ， 但 是 仍 被 视 为 大 块 内 存 ， 应 用 程序 把 数据 保存 在 这 些 内 存 区 域 以 便 能 够 快速 检 
索 。RedisChttp:/redis.io) 是 内 存 存 储 的 一 个 很 好 的 例子 。 

为 了 理解 这 类 框架 的 实用 性 , 再 次 考虑 Stack Overflow 公开 的 架构 。StackOverflow 
(www.stackoverflow.com) 使 用 定制 版 本 的 Redis 作为 一 个 中 间 的 二 级 绥 存 , 用 来 长 时 
间 地 维护 问题 和 数据 ， 从 而 不 需要 重新 售 询 数据 库 。Redis 文 持 做 盘 级 持久 化 、LRU 
逐 出 、 复 制 和 分 区 。 在 ASPNET Core 中 不 能 直接 访问 Redis， 但 是 可 以 通过 
ServiceStack API( 参 见 http://servicestack.net) 访 问 。 

Apache Cassandra 是 另外 一 个 NoSQL 内 存 数 据 库 , 可 通过 DataStax 驱动 程序 在 
ASPNET Core 中 访问 。 


9.3 ”EF Core 的 常见 任务 


如 果 希 望 保 持 在 ASPNET Core 的 完整 O/RM 的 领域 内 ， 可 选择 的 只 有 Entity 
Framework 的 新 的 、 定 制 的 版 本 ， 即 EF Core。EF Core 文 持 提供 程序 模型 ， 通 过 这 
个 模型 可 以 使 用 多 种 关系 DBMS， 具 体 来 说 包括 SQL Server、Azure SQL Database、 
MySQL 和 SQLite。 对 于 这 些 数据 库 ，EF Core 有 一 个 原生 提供 程序 。 而 且 ， 还 有 一 
个 内 存 提 供 程序 ， 非 钊 适合 测试 目的 。 对 于 PostgreSQL， 需 要 使 用 http://npgsql.org 
提供 的 一 个 外 部 提供 程序 。 用 于 EF Core 的 Oracle 提供 程序 预计 在 2018 年 上 半年 
可 用 。 

要 在 ASPNET Core 应 用 程序 中 安装 EF Core， 需 要 Microsoft EntityFrameworkCore 
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包 ， 以 及 想 要 使 用 的 数据 库 提 供 程 序 的 具体 包 (SQL Server、MySQL、SQLite 等 )。 
下 面 介 绍 使 用 EF Core 执行 的 最 常见 的 任务 。 


9.3.1 建 模 数据 库 


EF Core 只 文 持 Code First 方 法 ,这 意味 看 它 需 要 一 组 类 来 揪 述 数据 库 和 容 右 表 。 
可 以 从 头 编写 这 一 组 类 ， 也 可 以 通过 一 些 工具 ， 对 某 个 现 有 数据 库 进行 逆向 工程 来 
得 到 这 组 类 。 


1. 定义 数据 库 和 模型 


数据 库 最 终 是 按照 一 个 派生 自 DbContext 的 类 进行 建 模 的 。 这 个 类 包含 一 个 或 
多 个 类 型 为 DbSet<T> 的 集合 属性 ， 其 中 工 是 表 中 记录 的 类 型 。 下 面 给 出 了 一 个 示 
例 数据 库 的 结构 。 

public class YourDatabase : DbConteXt 

{ 


public DbSet<Customer> Customers { get; set } 
} 


Customer 类 型 描述 了 Customers 表 中 的 记录 。 撒 层 的 物理 关系 数据 库 需 要 有 一 
个 名 为 Customers 的 表 ， 其 模式 与 Customer 类 型 的 公有 接口 相 匹 配 。 


public class EntityBase 


{ 
public EntityBase() 
{ 
Enabled = true; 
Modified = DateTime .UtcNow; 
} 


Public bool Enabled { get set; } 
public DateTime? Modified { get; set; |} 
} 
public class Customer : EntityBase 
{ 
[Keyl] 
Public int Id 1 get; set | 


Public string FirstName { get sets; |} 
public string LastName | get; set } 
} 


在 布局 Customer 类 的 公有 接口 时 ， 仍 然 可 以 使 用 第 用 的 面 问 对 象 技术 ， 并 使 用 
基 类 在 所 有 的 表 之 间 共 享 公共 的 属性 。 在 示例 中 , 当 表 映射 到 的 类 继承 目 EntityBase 
时 ， 这 些 表 中 将 自动 添加 Enabled 和 Modified 属性 。 另 外 ， 注 意 任 何 将 会 生成 表 的 
类 必须 定义 一 个 主键 字段 。 例 如 ， 这 可 以 通过 Key 特性 实现 。 
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重要 / 


数据 库 的 模式 和 映射 到 的 类 必须 始终 保持 同步 ; 否则 ，EF Core 将 抛 出 异 第 。 
这 意味 着 即使 在 表 中 添加 一 个 新 的 可 空 列 ， 也 会 是 一 个 问题 。 另 一 方面 ， 向 类 添加 
一 个 公有 属性 也 可 能 会 造成 问题 。 不 过 ， 在 这 种 情况 中 ， 使 用 NotMapped 特性 就 不 
会 抛 出 异常 。 事 实 上 ，EF Core 假定 只 会 通过 它 的 迁移 脚本 与 物理 数据 库 交 互 。 迁 
移 脚本 是 使 模型 和 数据 库 保持 同步 的 官方 方式 。 但 是 , 迁移 主要 是 开发 人 员 的 工作 ， 
而 数据 库 通 第 是 IT 部 门 的 财产 。 在 这 种 情况 下 ， 模型 和 数据 库 之 间 的 迁移 只 能 手动 


2. 注入 连接 字 付 捉 


在 上 面 的 代码 中 ， 看 不 到 代码 与 数据 库 之 间 的 物理 连接 。 那 么 ， 如 何 注 入 连接 
字符 串 呢 ? 从 技术 上 讲 ， 从 DbContext 派生 的 类 并 没有 被 完整 配置 ， 还 必须 指定 提 
供 程序 和 运行 它 所 需 的 所 有 信息 (最 主要 的 是 连接 字符 串 )， 这 样 才 能 让 这 个 关 操 作 
数据 库 。 可 以 设置 一 个 提供 程序 ,使 其 重 与 DbContext 类 的 OnConfiguring 方法 。 议 
方法 接受 一 个 选项 生成 器 对 象 ， 后 者 为 每 个 原生 文 持 的 提供 程序 都 提供 了 一 个 扩展 
方法 ， 包 括 SQL Server、SQLite 以 及 一 个 仅 用 于 测试 的 内 存 数据 库 。 要 配置 SQL 
Server( 包 括 SQL Express 和 Azure SQL Database)， 震 要 使 用 下 面 的 代 但 。 


public class YourDatabase : DbConteXt 


| 
public DbSet<Customer> Customers { get; set } 


protected override void OnConfiguring (DbhbContextOptionsBulilder optionsBulilder) 
{ 
OpPt1LIonsBuUlTader-UseSdLSerVver (- --- )- 
} 
} 


UseSqlServer 的 参数 必须 是 连接 字 付 串 。 如 朵 连接 字符 串 可 以 是 常量 ， 则 只 天 
要 在 上 面 代码 段 中 的 省 略 扎 位置 键入 该 字符 串 。 但 是 ， 更 现实 的 情况 是 ， 需 要 对 不 
同 的 环境 (生产 、 暂 存 、 开 发 等 ) 使 用 个 同 的 连接 字符 串 。 在 这 种 情况 下 ， 束 需要 找 
到 一 种 方式 来 注入 连接 字符 串 。 

因为 连接 字符 串 不 会 动态 变化 (如 采 确 实 发 生变 化 ， 融 属于 一 种 很 特殊 的 场景 ， 
需要 作 特 殊 处 理 ), 所 以 首先 想到 的 选项 是 在 DbContext 基 中 添加 一 个 全 局 衣 态 属性 ， 
以 便 将 其 设置 为 连接 字符 串 。 


Public static string Connectionstring = ™"? 


现在 ,ConnectionString 属性 将 被 悄悄 传递 给 OnConfiguring 方法 的 UseSqlServer 
方法 。 通 音 从 配置 文件 中 读 取 连接 字符 串 ， 并 在 应 用 程序 局 动 时 设置 它 。 
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public void Configure (IApplicationBuilder app, IHostingEnvironment enmv) 


{ 

YourDatabase.Connectionstring = lenv.lsDevelopment ( ) 

2 production connection string™ 
"development connection string"} 

// More code here 
} 
类 似 地 ， 可 以 为 生产 和 开发 使 用 不 同 的 JSON 配置 文件 ， 并 在 其 中 存储 要 使 用 

pre 从 运 维 的 角度 看 ， 这 种 方法 可 能 也 更 加 简单， 因为 按照 约定 ， 发 布 


脚本 只 会 选择 正确 的 JSON 文件 (参见 第 2 章 )。 
3. 注入 DbContext 对 象 


如 果 搜 索 EF Core 的 相关 文章 , 包括 Microsoft 的 官方 文档 , 会 看 到 许多 示例 都 
采用 了 与 下 面 的 代码 段 相同 的 指导 原则 。 


Public void ConfigqureServices (IServiceCollection services) 


{ 
Var ConnSstring = Configuration.GetConnectionString(" "YourDatabase™}); 
Services.AddDbContext<YourDatabase> (options 三 > 
options .UseSqgqlServer (connstring)}) ); 
} 


代码 将 YourDatabase 上 下 文 对 象 添加 到 DI 子 系统 中 ， 从 而 能 够 在 应 用 程序 的 
任何 地 方 获取 该 对 象 。 添 加 上 下 文 的 时 候 ， 代 码 还 对 其 进行 了 完整 的 配置 ， 使 其 
作用 域 为 当前 的 请 求 ， 并 且 ( 在 本 例 中 ) 在 指定 连接 字符 串 上 使 用 了 SQL Server 提 
供 程 序 。 

为 一 种 方法 是 ， 目 己 创建 数据 库 上 下 文 的 实例 ,根据 需要 为 它们 分 配 生 存 期 (如 
singleton 或 scoped)， 并 在 上 下 文中 只 注入 连接 字符 串 。 上 和 耐 讨论 过 的 静态 属性 也 可 
作为 一 个 选项 。 下 而 给 出 了 为 外 一 个 选项 。 

public YourDatabase (IOptions<GlobalConfig> config) 

// Save to a local variable the connection string 

// as read from the configuration JSON file of the application. 

} 

如 第 7 elie 可 以 应 用 Options 模式 ， 将 全 局 配置 数据 从 JSON 资源 加 载 到 
一 个 类 中 ， 然 后 通过 DI 将 这 个 类 注入 其 他 类 构造 函数 中 。 


) 土 瑟 ; 
注入 连接 字符 串 的 方法 有 很 多 ， 应 该 选择 哪 种 方法 呢 ? 我 个 人 选择 使 用 静态 
性 ， 因 为 这 种 方法 简单 、 直 接 并 易于 理解 和 使 用 。 其 次 ， pc 
DbContext。 至 于 将 完全 配置 的 DbContext 注入 DI 系统 ， 这 种 方法 让 我 不 安 ， 因 为 
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这 可 能 导致 开发 人 员 在 有 需要 的 地 方 就 调用 DbContext， 让 为 隔离 关注 点 所 做 的 努 
力 功 亏 一 筑 . 


4. 目 动 创建 数据 库 


建 模 数据 库 并 将 其 映射 到 类 的 整体 流程 与 在 EF6 中 有 一 点 区 别 ， 当 数据 库 还 不 
存在 时 ， 创 建 数据 库 所 需 的 代码 也 与 EF6 有 一 些 区 别 。 在 EF Core 中 ， 必 须 显 式 请 
求 这 个 步骤 ， 它 不 再 由 数据 库 初始 化 程序 实现 。 如 果 想 要 创建 一 个 数据 库 ， 需 要 把 
下 面 的 两 行 代 码 放 到 启动 类 的 Configure 方法 中 : 


var db = new YourDatabase (1) ， 
db.Database.EnsureCreated().,，} 


如 果 数 据 库 还 不 存在 , EnsureCreated 方法 就 会 创建 数据 库 , 硅 则 会 跳 过 此 方法 。 
将 初始 数据 加 载 到 数据 库 的 操作 也 可 在 代码 中 完全 控制 。 常 用 的 模式 是 在 
DbContext 类 中 公开 一 个 公有 方法 (名 称 由 你 自己 决定 )， 然 后 在 EnsureCreated 方法 
之 后 调用 该 方法 。 


db.Database.SeedTables ();} 


在 初始 化 程序 中 ， 可 以 直接 调用 EF Core 方法 ， 或 者 如 果 定 义 了 存储 库 ， 也 可 
以 调用 它们 。 


注意 : 
国 通过 许多 命令 行 工具 ， 可 以 控制 基 架 任务 ， 例 如 对 现 有 数据 库 进行 逆向 工程 或 
将 类 的 变化 迁移 到 数据 库 . 更 多 细节 请 访问 网 址 http://docs.microsoft.com/en-us/ef/core/ 
get-started/aspnetcore/existing-db. 


9.3.2 处理 表 数 据 


总 体 上 ， 使 用 EF Core 读 写 数据 与 使 用 EF6 是 相同 的 。 当 正确 地 创建 了 数据 库 
或 者 对 东 个 现 有 数据 库 进行 逆 癌 工程 后 ， 碍 询 和 更 新 的 工作 方式 是 相同 的 。EF6 和 
EF Core 的 API 之 间 存 在 一 些 区 列 ， 但 是 总 体 上 ， 我 认为 最 好 按照 EF6 中 的 方式 进 
行 操作 ， 只 有 当 例 外 情况 确实 出 现时 ， 才 关注 它们 。 


1. 获取 记录 


下 和 面 的 代码 显示 了 如 何 按照 主键 获取 记录 。 这 种 方法 更 加 通用 ， 显 示 了 如 何 根 
据 条 件 获 取 记录 。 
public Customer FindByld(int id) 


{ 


using (var db = new YourDatabase ()) 
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Var customer = (from c in db.Customers 
where c.Id == id 
select c) .FirstorDefault () ; 
return customer; 


} 


相 比 代码 本 身 ， 有 了 两 点 更 加 重要 。 
e 首先 ， 代 码 被 封装 到 一 个 存储 库 类 的 方法 中 。 存 储 库 类 是 一 个 封装 类 ,， 它 使 
用 DbContext 的 新 实例 或 者 注入 的 副本 (只 体 使 用 什么 由 你 目 己 决定 ) 来 公开 
数据 库 操作 。 
e 其 次 ， 上 面 的 代码 可 以 算是 一 个 整体 。 它 打开 了 一 个 数据 库 连 接 ， 获 取 数 据 
库 中 的 数据 ， 然 后 关闭 连接 。 这 些 操作 都 发 生 在 一 个 透明 的 数据 库 事务 中 。 
如 果 需 要 运行 两 个 不 同 的 人 查询, 就 要 考虑 到 ,两 次 调用 一 个 存储 库 方法 会 打 
开 / 关 闭 与 数据 库 的 连接 两 次 。 
如 果 正 在 编写 的 业务 流程 需要 对 数据 库 执 行 两 次 或 更 多 次 得 询 ， 那 么 可 以 共计 
在 一 个 透明 事务 中 把 它们 连接 起 来 。DbContext 实例 的 作用 域 决 定 了 系统 创建 的 数 
据 库 事务 的 作用 域 。 


public Customer [] FindAdminAndSsupervisor () 


{ 
USing (var db = new YourDatabase()) 
{ 
var admin = (tromc in db.customers 
where c.Id == ADMIN 
select c) .FirstOrDefault (}); 
Var SuUupervisor = (from C in db.Customers 
where c.1Id == SUPERVISOR 
select c) .FirstOrDefault (}); 
return new[|] {admin, supervisor}; 
} 
} 


在 本 例 中 , 通过 不 同 的 得 询 检索 两 条 记录 , 不 过 这 两 个 合 询 位 于 同一 个 事务 内 ， 
在 同一 个 连接 上 执行 。 为 一 个 值得 注意 的 用 例 是 ， 整 个 查询 是 一 点 扩 构建 的 。 假 设 
有 一 个 方法 获取 一 块 记录 ， 其 输出 被 传递 给 为 一 个 方法 ， 以 便 基于 运行 时 条 件 进 一 
步 限 制 结果 集 。 下 耐 给 出 了 一 些 示例 代 公 : 


// Opens a connection and returns all EU customers 
Var customers = FindByContinent ("EU").; 


// Runs an in-memory query to select only those from EAST EU 
if (someConditijonsApply()) 
{ 
customers = (fromc in customers Where c.Area.Is("EAST") select c) .ToList(); 


} 
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最 终 能 够 得 到 目 己 需要 的 结果 ， 但 是 内 存 使 用 量 不 是 最 优 的 。 下 面 给 出 了 一 种 
更 好 的 方法 。 


public IQueryable<Customer> FindByContinent (string continent) 


{ 
Var customers = (from c in db.Customers 
where c.Continent == continent 
select C) 7; 
// No query is actually run at this point! Only the formal 
// definition of the query is returned. 
return customers; 
} 


在 查询 表达 式 的 末尾 不 调用 FirstOrDefault 或 ToList 并 不 会 实际 运行 查询 ; 相反， 
只 是 返回 查询 的 描述 。 


// Opens a connection and returns all EU customers 
Var Query = FindBycContinent ("EU™); 


// Runs an in-memory query to select only those from EAST EU 
if (someConditijonsApply()) 


{ 

query = (from C in query Where Cc.Area.Is("EAST") select Cr 
} 
Var customers = gquery.ToList(}); 


第 二 个 筛选 器 现在 只 是 编辑 查询 ， 添 加 一 个 额外 的 WHERE 子 句 。 接 下 来 ， 当 
调用 ToList 时 ， 运 行 该 查询 一 次 ， 获取 所 有 来 日 Europe 并 且 抽 住 在 East 的 客户 。 


2. 处 理 关 系 


下 面 的 代码 定义 了 两 个 表 之 间 的 一 对 一 关系 。Customer 对 象 引 用 Countries 表 
中 的 Country 对 象 。 


public class Customer : EntityBase 
{ 
[KeYj 
Public int Id { get; set; | 
public string FirstName 1{ get; set; | 
Public string LastName 1 get; set } 


[ForeignKeyl 

public int Countryld { get; set; } 

Public Country Country { get; set; |} 
} 


这 足以 让 数据 库 定 义 两 个 表 的 外 键 关 系 。 当 查询 客户 记录 时 ， 很 容易 通过 一 个 
底层 的 JOIN 语句 来 展开 Country 属性 。 


Var Customer = (from C in db.customers.Include ("Country") 
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where C.IQ == id 
select c) .FirstoOrDefault(); 


由 于 使 用 了 Include 调用 , 因此 返回 的 对 象 的 Country 属性 会 通过 配置 的 外 键 的 
JOIN 语句 进行 填充 。 传 递 给 Include 的 字符 串 就 是 外 键 属性 的 名 称 。 从 技术 上 讲 ， 
在 一 条 查询 语句 中 ， 可 以 有 任意 数量 的 nclude 调用 。 但 是 ， 使 用 的 Include 调用 越 
多 ， 返 回 的 对 象 图 和 额外 占用 的 内 存量 也 会 增加 。 


3. 添加 记录 


要 添加 一 条 新 记录 ， 需 要 编写 一 些 代码 在 内 存 中 添加 一 个 对 象 ， 然 后 把 集合 持 
久 化 到 磁盘 。 


public void Add (Customer customer) 
{ 
ift (customeTr == null) 
returns 
using (var db = new YOUTDatabase () ) 
{ 
db.Customers.Add (customer); 
try 
{ 
db.sSsaveChanges ();} 
} 
catch (Exception except1ion) 
{ 
// Recover in some Way or expand the way 
// it works for you, For example, only catching 
// some exceptions. 


} 

} 

只 要 传递 的 对 象 被 完整 配置 ， 并 且 所 有 必要 字段 都 被 填充 ， 那 么 上 面 这 些 代 但 
就 是 够 了 。 对 于 数据 访问 层 ， 一 个 好 方法 是 从 业务 角度 出 发 ， 在 应 用 层 (在 控制 占 调 
用 的 服务 类 中 ) 验 证 对 象 ， 然 后 假定 存储 库 中 一 切 正常 ， 或 者 如 果 发 生 问 题 ， 就 抛 出 
异常 。 又 或者， 在 存储 库 方 法 中 ， 可 以 做 一 些 检 查 ， 确 保 一 切 正常 。 

4. 更 新 记录 

在 EF Core 中 ， 更 新 记录 涉及 两 个 步骤 。 首 先 ， 查 询 要 更 新 的 记录 。 然 后 ， 在 
相同 的 DbContext 中 ， 更 新 记录 在 内 存 中 的 状态 并 持久 化 修改 。 


public void Update (Customer updatedCustomer) 


{ 
USlInG (var db = new YourDatabase ()) 
{ 
// Retrieve the record to update 
Var customer = (from c jin db.Customers 
where c.1Id == updatedcCustomer.Id 
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select c) .FirstoOrDefault (); 
1ft (customer == null) 
returns 


// Make changes 

customer.FirstName = updatedCustomer.FirstName; 
customer.LastName = updatedCustomer.LastName; 
customer.Modified = DateTime .UtcNow; 


// Persist 


try 
{ 
db.SaveChanges (); 
} 
catch (Exception exception,) 
{ 
// Recover in some way or expand the way 
// it works for you, For example, only catching 
// some exceptions. 
} 


} 


使 用 提交 的 记录 更 新 获取 的 记录 时 ， 要 编 与 的 代码 十 分 枯燥 。 虽 然 手 动 地 逐个 
字段 复制 肯 定年 最 人 的 方法 ， 但 是 使 用 反射 或 者 高 级 工具 (如 AutoMapper) 可 以 节省 
时 间 。 另 外 ， 只 需要 与 一 行 代码 惑 能 克隆 对 象 是 很 有 帮助 的 。 不 过 ， 虽 然 如 此 ， 要 
考虑 到 更 新 记录 主要 是 项 业务 操作 ， 而 不 是 单纯 的 数据 库 操 作 ， 只 有 在 微不足道 
的 应 用 程序 中 ， 这 二 者 才 会 重合 。 这 里 要 表达 的 是 ， 取 决 于 业务 条 件 ， 一 些 字 段 任 
何 时 候 都 不 应 该 更 新 ， 或 者 只 应 该 获得 系统 计算 出 的 值 。 不 止 如 此 ， 有 时 只 更 新 
记录 是 不 够 的 ， 还 需要 在 同一 个 业务 事务 的 上 下 文中 执行 其 他 操作 。 这 意味 看 虽 
然 一 开始 看 起 来 ， 在 一 个 更 新 方法 中 ， 什 么 都 不 考 夸 ， 直 接 将 属性 从 源 对 象 复 制 
到 目标 对 象 是 一 种 很 钊 见 的 场景 ， 但 其 实 并 非 如 此 。 稍 后 在 讨论 事务 时 还 会 继续 
说 明 这 一 点 。 


5. 删除 记录 


删除 记录 与 更 新 记录 类 似 。 在 删除 记录 时 ， 必 须 获 取 要 删除 的 记录 ， 从 数据 库 
的 内 存 集合 中 删除 该 记录 ， 然 后 更 新 物理 表 。 


public void Delete (Int 1id) 


{ 
USing (var db = new YourDatabase()) 
{ 
// Retrieve the record to delete 
Var customer = (from C in db.Customers 
where c.Id == id 
select c) .FirstoOrDefault (}); 
if (customer == null]l) 
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returns 
db.Customers.Remove (customer); 


/i Persist 
try 
{ 


db.SaveChanges (); 

J except1ion) 

{ 
// Recover in some way or expand the way 
// it works for you, For example, only catching 
// some exceptions. 

} 

} 

} 

天 于 删除 操作 ， 有 两 点 需要 注 是 。 首 先 ， 删 除 也 是 业务 操作 ， 而 业务 操作 极 少 
需要 销毁 数据 。 一 般 来 说 ， 删 除 记录 是 在 多 辑 上 删除 它 ， 这 其 实 是 使 删除 操作 成 为 
更 新 操作 。EF6 和 EF Core 中 的 删除 操作 的 实现 看 起 来 令 人 生 豚 ， 但 是 为 应 用 任何 
所 需要 的 逻辑 留 下 了 空间。 

如 果 确实 需要 从 数据 库 中 物理 删除 记录 ， 而 不 考虑 数据 库 级 别 是 否 配置 了 级 联 
选项 ， 那 么 可 以 使 用 普通 的 SQL 语句 。 


db.Database.ExecuteSqlCommand (sgql1);} 


一 般 来 说 ,我 建议 你 (和 你 的 客户 ) 在 物理 删除 记录 之 前 要 三 思 。 长 远 的 开发 需 
要 着 眼 于 事件 的 可 济源 性 ， 而 事件 溯源 的 核心 之 一 就 是 数据 库 采 用 只 追加 结构 的 


设计 。 
9.3.3 ”处 理事 务 


在 只 实 的 应 用 程序 中 ， 大 部 分 数据 库 操作 都 是 事务 的 一 部 分 ， 有 时 是 分 布 式 事 
务 的 一 部 分 。 默 认 情 况 下 ， 如 有 果 搬 层 数据 库 提 供 程 序 文 持 事务 ， 那 么 调用 一 次 
SaveChanges 要 保存 的 所 有 修改 将 在 一 个 事务 内 处 理 。 这 意味 看 如 果 任 意 一 条 修改 失 
败 ， 整 个 事务 将 会 回 滚 ， 使 得 所 有 演 试 要 做 的 修改 都 不 会 物理 应 用 到 数据 库 。 换 名 
话说 ，SaveChanges 要 么 完成 它 要 做 的 所 有 工作 ， 要 么 什么 都 不 做 。 


1. 显 式 控制 事务 


当 不 能 通过 调用 一 次 SaveChanges 保存 所 有 修改 时 ， 可 以 通过 DbContext 类 上 
的 一 个 专门 的 方法 ， 定 义 一 个 显 式 的 事务 。 


using (Var db = new YourDatabase () ) 


{ 
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using {var tx = ap.Database.BedinTITransaction() ) 
{ 

try 

{ 


// All database calls including multiple SaveChanges calls 


// Commit 

tx.Commit (); 
} 
catch (Exception exception,) 
{ 


// Recover in some Way or expand the Way 
// it works for you, For example, only catching 
// some exceptions. 


} 


同样 要 注意 ， 并 不 是 所 有 的 数据 库 提 供 程序 都 可 能 文 持 事 务 。 但 是 ， 流 行 的 数 
据 库 (如 SQL Server) 的 提供 程序 部 文 持 事务 。 当 提供 程序 不 文 持 事务 时 会 发生 什么 ? 
这 要 取决 于 提供 程序 目 喘 : 要 么 抛 出 一 个 卉 间 ， 要 么 什么 部 不 做 。 


2. 共享 连接 和 事务 


在 EF Core 中 创建 DbContext 对 象 的 实例 时 ， 可 以 注入 一 个 数据 库 连 接 和 /或 一 
个 各 务 对 象 。 这 册 个 对 象 的 基 类 分 别 是 DbConnection 和 DbTransaction。 

如 果 将 相同 的 连接 和 事务 注入 两 个 不 同 的 DbContext 对 象 中 ， 那 么 这 两 个 上 下 
文中 的 所 有 操作 将 发 生 在 同一 个 数据 库 连 接 上 和 同一 个 事务 内 。 下 面 的 代 但 段 演 示 
了 如 何在 DbContext 中 注入 一 个 连接 。 


public class YourDatabase : DbContext 
{ 
private DbhConnection connectlion; 
Public YourDatabase (DhbConnection connection) 
{ 
connection = connection; 


} 


Public DbSet<Customer> Customers { get; Set 上 
protected override Vold OnConfiguring (DbContextOoOptionsBuilder optionsBuilder) 
{ 
optionsBulilder.UsesqlSsServer( connection); 
} 
} 


要 注入 一 个 事务 作用 域 ， 则 需要 使 用 下 面 的 代 伍 : 
CoOnteXt .Database .UseTransaction (transaction); 


要 从 正在 运行 的 事务 中 获得 一 个 事务 对 象 ， 需 要 使 用 GetDbTransaction 方法 。 
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更 多 信息 请 访问 http://docs.microsoft.com/en-us/ef/core/saving/transactions。 


注意 : 

-一 .NET Core 2.0 中 添加 了 一 些 对 TransactionScope 的 支持 ， 但 是 在 开始 认真 进行 
开发 之 前 ， 建 议 仔细 检查 ， 确 保 在 想 要 使 用 TransactionScope 的 场景 中 ， 它 可 以 工 

作 。 这 个 类 是 存在 的 ， 但 是 就 目前 来 看 ， 其 行为 与 其 在 完整 的 NET Framework 中 似 

乎 不 同 。 顺 便 提 一 句 ， 完 整 的 NET Framework 中 的 TransactionScope 允许 同时 使 用 

关系 事务 、 文 件 系统 和 /或 Web 服务 操作 . 


9.3.4 天 于 异步 数据 处 理 


在 EF Core 中 ， 可 触发 数据 库 操 作 的 所 有 方法 都 有 一 个 异步 版 本 ， 例 如 
SaveChangesAsync、FirstOrDefaultAsync、ToListAsync 等 (这 里 只 是 列 出 了 最 和 常用 的 
方法 的 异步 版 本 )。 那 么 ， 应 该 使 用 这 些 异 步 版 本 吗 ? 它们 能 够 提供 什么 样 的 优势 ? 
在 ASPNET Core 应 用 程序 中 ， 异 步 处 理 有 什么 意义 ? 

寞 步 处 理 本 喘 并 不 比 同步 处 理 快 。 但 是 ， 寞 步调 用 的 执行 流 要 比 同步 调用 更 加 
复杂 。 在 Web 应 用 程序 中 ， 开 步 处理 主 要 是 为 了 在 等 符 同 步调 用 返回 时 ， 线 程 不 会 
阻 显 ， 而 不 是 为 了 处 理 后 面 的 请 求 。 因 此 ， 整 个 应 用 程序 能 够 接受 和 处 理 更 多 请 求 ， 
所 以 啊 应 性 变 得 更 好 。 这 了 束 让 人 感觉 速度 提高 了 ， 更 重要 的 是 ,可 扩展 性 也 变 好 了 。 

C# 语 言 使 用 async/await 关键 字 , 以 非常 简单 的 方式 将 明显 的 同步 代码 转换 为 异 
步 代码 。 但 是 ， 权 力 越 大 ， 贡 任 越 大 ， 有 些 工 作 人 负载 可 能 不 需要 寞 步 处 理 ， 所 以 一 
定 要 知道 在 生成 额外 的 线程 来 处 理工 作 负 载 时 需要 的 开销 。 记 住 ， 在 这 里 处 理 的 不 
是 并 行 ， 而 是 将 工作 负载 转 友 给 另外 一 个 线程 ， 当 前 线程 则 返回 线程 池 ， 处 理 更 多 
传 入 的 请 求 。 可 扩展 性 变 得 更 好 ， 但 是 速度 上 可 能 会 受到 一 点 影响 。 


1. ASP.NET Core 应 用 程序 中 的 异步 处 理 


假设 将 一 个 控制 器 方法 标记 为 异步 方法 。 代 人 码 从 茶 个 网 站 下 载 内 容 ， 并 跟踪 异 
步 操作 之 前 和 之 后 的 线程 ID。 


public async Task<IActijonResult> Test () 

{ 
Var 七 = Thread.CcurrentThread.ManagedThreadlId.ToSsString(}); 
Var Client = new HttpClient (); 
await client.GetSstringAsync ("http://www.google.com"™);} 
Var t2 = Thread.CurrentThread.ManagedThreadlId.ToSsString(}); 
return Content (string.Concat (tl, ™ / ", t2)); 

} 


代 人 码 的 效果 如 图 9-5 所 示 。 
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关 http://localhost:50543/home/test 7 ©& || Search.. 


总 localhost x|LT 名 
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图 9-5 开 步 操作 之 前 和 之 后 的 线程 DD 


如 图 所 示 ， 在 异步 操作 之 前 和 之 后 ， 处 理 请 求 的 是 不 同 的 线程 。 对 特定 页 面 的 请 
求 并 没有 真正 从 这 个 异步 实现 获 益 ， 但 是 网 站 的 其 余部 分 则 可 以 。 原 因 在 于 ， 没 有 
ASPNET 线程 在 忙于 等 待 某 个 IO 操作 完成 。 在 请 求 .NET 线程 池 调用 GetStringAsync 
异步 操作 之 后 ，9 号 线程 返回 ASPNET 池 ， 以 处 理 任何 新 传 入 的 请 求 。 当 异步 方法 
完成 后 ， 将 开始 执行 线程 池 中 第 一 个 可 用 的 线程 。 这 个 线程 可 能 是 9 号 线程 ， 也 可 
能 是 其 他 线程 。 在 高 流量 网 站 中 ， 在 耗 时 操作 占用 的 数秒 内 ， 传 入 的 请 求 数量 可 能 
一 直 很 高 ， 还 可 能 降低 网 站 的 啊 应 性 。 


2. 数据 访问 中 的 异步 处 理 


要 让 线程 返回 线程 池 , 准备 好 处 理 男 一 个 请 求 , 该 线程 必须 等 待 一 个 异步 操作 。 
这 种 语法 表述 起 来 可 能 让 人 感到 困惑 : 当 看 到 await MethodAsync 出 现时 ， 意 味 看 
当前 线程 将 对 MethodAsync 的 调用 推 入 .NET 线程 池 并 返回 。MethodAsync 调用 之 
后 的 代码 在 该 方法 返回 后 , 将 在 任何 可 用 的 线程 上 执行 ,调用 Web 服务 也 是 可 行 的 。 
另 一 种 可 行 的 方法 是 通过 EF Core 异步 调用 某 个 数据 库 。 

考 谍 一 种 前 见 的 场景 。 假 议 有 一 个 由 毅 态 内 容 构成 的 Web 应 用 程序 ， 视 图 的 洽 
染 速 度 相 对 较 快 ， 并 且 由 于 一 些 视 网 需要 运行 时 间 较 长 的 数据 库 操 作 ， 运 行 速度 比 
其 他 视图 慢 得 多 。 

假设 有 许多 并 发 请 求 耗 尽 了 线程 池 。 其 中 的 一 些 请 求 需 要 访问 数据 库 ， 因 而 所 
有 这 些 线程 用 于 处 理 请 求 ， 但 是 实际 上 是 衬 亲 的， 等待 厦 数据 库 得 询 返 回 。 系 统 无 
法 处 理 更 多 请 求 ， 但 是 CPU 的 使 用 率 几 乎 为 0! 看 起 来 将 数据 库 访 问 转 换 成 卉 步 代 
码 能 够 解决 问题 ， 但 实际 上 ， 这 要 视 情 况 而 定 。 

首先 ,要 将 数据 库 访 问 转换 成 异步 代 但 , 意味 痢 要 重 构 数 据 访 问 层 的 大 量 代 但 。 
不 管 怎么 看 ， 这 都 不 会 是 一 个 轻松 的 任务 。 不 过 ， 我 们 还 是 假设 重 构 了 代码 。 这 样 
一 来 ， 另 一 个 问题 是 ， 转 换 成 异步 代码 后 ， 真 正 实 现 的 是 让 更 多 线程 回 到 线程 池 ， 
;准备 处 理 其 他 传 入 请 求 。 但 是 ， 如 果 要 处 理 这 些 请 求 ， 也 需要 访问 数据 库 ， 会 发 生 
什么 ?把 数据 访问 代码 转换 成 寞 步 模 式 ， 得 到 的 结果 只 是 让 数据 库 变 得 时 加 拥堵 ! 
之 所 以 转换 成 弄 步 模式 ， 是 因为 数据 库 太 慢 ， 不 能 及 时 啊 应 传 入 的 请 求 ， 但 是 这 么 
做 ,只 是 同 数 据 库 发 送 了 哆 多 人 查询。 这 并 不 是 解决 问题 的 方法 。 在 Web 服务 左 和 数 
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据 库 之 间 诡 加 一 个 缓存 是 更 好 的 解决 方案 。 人 花 一 些 时 间 来 测量 分 布 式 应 用 程序 在 有 
负载 的 情况 下 的 性 能 ， 如 宁 有 需要 ， 上 再 更 痢 代 介 和 架构 。 

太一 方面 ， 这 并 不 是 唯一 可 能 出 现 的 场景 。 偿 有 可 能 发 生 的 是 ， 转 换 为 开 步 模 
陈 后 能 够 处 理 更 多 的 请 求 ， 因 为 请 求 的 是 静态 资源 或 简单 页 向。 在 这 种 情况 下 ， 网 
站 将 给 用 户 提 供 啊 应 速度 好 得 多 的 体验 ， 也 会 提供 更 好 的 可 扩展 性 。 


3. 布 望 使 哪个 服务 器 变 慢 


在 我 看 来 , 当 网 站 由 于 运行 时 间 长 (与 CPU 无 关 ) 的 操作 而 导致 啊 应 速度 慢 时 ， 
就 应 该 做 一 个 决定 : 对 于 Web 服务 与 数据 库 服 务 占 ， 能 够 接受 哪个 服务 器 的 速度 
变 慢 ? 

一 般 来 说 ， 相 比 数据 库 服 务 器 ，ASPNET 线程 池 能 够 处 理 多 得 多 的 并 发 请 求 。 
性 能 计数 器 会 告诉 你 ， 问 题 是 实际 的 HITP 流量 对 于 IIS 配置 而 言 过 高 ， 或 者 Web 
服务 器 没有 问题 ， 但 是 数据 库 处 境 艰 难 。 在 IS/ASPNET 配置 中 ， 有 一 些 设置 可 增 
加 每 个 CPU 处 理 的 请 求 数 和 线程 数 。. 如 果 数 据 显 示 , 快速 请 求 成 为 队列 中 的 牺牲 品 ， 
那么 简单 地 提高 这 个 数字 要 比 把 代码 转换 为 异步 代码 更 快 。 

如 果 数 据 显 示 ， 数 据 库 接受 了 太 多 需要 很 长 时 间 才 能 完成 的 查询 请 求 ， 成 为 了 
租 纲 ， 那 么 就 需要 审 但 后 羡 的 整体 架构 ， 或 者 想 办 法 使 用 绥 存 ， 还 有 一 种 方法 是 所 
高 查询 的 效率 。 

后 痛 架 构 的 变化 可 能 意味 看 将 请 求 秋 载 到 一 个 外 部 队列 ， 让 队列 在 处 理 完 请 求 
后 回调 。 最 好 把 运行 时 间 长 的 但 斧 作 为 “发 后 不 理 ” 的 操作 。 我 知道 ， 这 种 方法 可 
能 需要 一 个 完全 不 同 的 、 基 于 消息 的 架构 。 但 是 ， 这 是 向 上 扩展 的 关键 。 异 步 处 理 
每 个 操作 并 不 能 保证 极 高 的 性 能 ， 但 也 不 会 是 性 能 杀手 。 不 要 其 台 目 己 ， 认 为 异步 
处 理 能 够 解决 一 切 问 题 。 


9.4 ”小 纺 


ASPNET Core 应 用 程序 能 够 通过 多 种 方式 访问 数据 。EF Core 并 不 是 唯一 的 选 
项 , 但 是 这 个 O/RM 是 专门 为 .NET Core 平台 设计 的 ， 能够 在 ASPNET Core 中 很 好 
地 工作 。 在 本 章 看 到 ， 可 以 使 用 ADO.NET 及 微型 O/RM 来 创建 数据 访问 层 。 我 的 
建议 是 ， 将 数据 访问 层 视 为 一 个 独立 的 层 ， 并 且 使 其 不 直接 依赖 于 表示 层 ， 但 是 可 
以 依赖 于 应 用 层 ， 并 在 应 用 层 中 集中 处 理 所 有 的 工作 流 。 
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第 IV 部 分 关注 应 用 程序 前 端 ， 介 绍 用 于 构建 高 可 用 的 现代 表示 层 所 需 
的 技术 和 补充 框架 。 

第 10 曹 介绍 如 何 使 用 ASPNET Core 构建 真正 的 Web API， 使 其 返回 
JSON、XML 或 其 他 数据 。 使 用 这 些 技 术 可 以 解决 现代 应 用 程序 场景 中 普 所 存 
在 的 问题 ， 即 多 种 多 样 的 客户 端 不 断 调用 远程 后 端 来 下 载 数据 或 请 求 处 理 ， 

第 11 章 介绍 如 何 使 用 JavaScript 在 ASPNET Core 中 提交 数据 ， 而 没有 
原来 的 全 页 和 面 表单 刷新 的 开销 。 之 后 ， 第 12 章 将 介绍 如 何 通过 JavaScript 
直接 刷新 浏览 占 的 内 容 ， 而 不 必 到 新 加 载 。 该 章 将 演示 如 何 下 载 和 动态 巷 换 
一 个 HTML 页 面 的 一 部 分 , 并 设置 JSON 端点 , 使 得 客户 端 能 够 查询 这 些 端 
点 来 获取 新 数据 ， 从 而 完全 在 客户 新 于 狐 生成 HTML 布局 。 

第 13 草 将 完成 对 Web 应 用 程序 前 闹 的 介绍 。 在 该 革 中 ， 将 学 习 如 何 通 
过 能 够 输出 JavaScript 和 HIMLS 的 是 应 用 控件 来 模拟 原生 小 组 件 ， 元 服 一 
个 艰巨 的 挑战 : 在 iPhone 或 Android 上 交付 类 似 原 生 的 Web 应 用 程序 体验 。 
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设计 Web API 


不 管 天 翻 地 替 ， 我 们 都 得 生活 ， 
一 一 D. H. 劳伦斯 ,《 查 泰 莱 夫人 的 情人 》 


在 ASPNET Core 的 上 下 文中 ,Web API 这 个 术语 终于 具备 了 其 真正 的 意义 , 清 
晰 而 不 模糊 ， 不 需要 进一步 解释 其 特征 。Web API 是 一 种 编程 接口 ， 由 许多 公开 的 
HTTP 端点 构成 , 这 些 端点 通常 (但 并 非 必须 ) 返 回 JSON 或 XML 给 调用 方 。Web API 
非常 适合 如 今 的 一 种 相当 常见 的 应 用 程序 场景 : 客户 端详 用 程序 需要 调用 某 个 远程 
后 痛 来 下 载 数据 或 请 求 处 理 。 客 户 痛 应 用 程序 可 以 有 许多 形式 ， 包 括 JavaScript 密 
集 型 Web 页 面 、 军 客户 疹 或 移动 应 用 程序 。 本 章 将 介绍 如 何在 ASPNET Core 中 构 
建 Web API。 我 们 将 特别 关注 API 一 一 无 论 是 面向 REST 的 还 是 面向 过 程 的 一 一 的 
哲学 ， 以 及 如 何 保护 Web API 的 安全 。 


10.1 使 用 ASP.NET Core 构建 Web API 


Web API 的 核心 是 一 个 HITP 端点 集合 。 这 意味 着 在 ASPNET Core 中 , 如 果 应 
用 程序 配 有 一 个 终止 中 间 件 ， 且 该 中 间 件 能 够 解析 得 询 字 符 串 并 决定 要 采取 的 操作 ， 
那么 这 个 应 用 程序 就 是 一 个 极 简 的 但 是 可 以 工作 的 Web API。 不 过 ， 更 可 能 的 情况 
是 ， 使 用 控制 喜来 构建 Web API， 以 更 好 地 组 织 功能 和 行为 。 对 于 设计 API， 有 两 
种 主要 的 方法 。 可 以 公开 问 点 ， 使 其 引用 目 己 完全 控制 的 实际 业务 工作 流 和 操作 ， 
或 者 也 可 以 定义 业务 资源 ， 并 使 用 完整 的 HTTP 堆栈 (包括 头 、 参 数 、 状 态 介 和 动词 ) 
来 接受 输入 和 返回 输出 。 前 一 种 方法 是 面 加 过程 的 ， 通 第 被 称 为 RPC， 代 表 远 程 过 
程 调 用 (Remote Procedure Call)。 后 和 耐 一 种 方法 受到 了 REST 背 学 的 局 发 。 

REST 方法 更 加 标准 ， 并 且 一 般 来 说 ， 对 于 设计 企业 业务 内 的 公有 API， 更 加 
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推 存 使 用 这 种 方法 。 如 果 客 户 使 用 你 的 API， 那 么 应 该 根据 一 套 普 裔 接 受 的 、 为 人 
熟知 的 设计 规则 来 公开 目 己 的 API。 如 果 API 只 是 用 于 处 理 数 量 有 限 的 客户 端 ， 而 
且 这 些 客户 端 大 部 分 也 受到 API 创建 者 的 控制 , 那么 使 用 RPC 还 是 REST 设计 方法 
没有 真正 的 区 别 。 我 们 暂时 忽略 REST 原则 ， 而 关注 如 何在 ASPNET Core 中 公开 
HTTP JSON 端点 。 


10.1.1 公开 HTTP 端点 


尽管 可 以 在 终止 中 间 件 中 直接 艇 入 一 些 请 求 处 理 逻 辑 ， 但 最 常用 的 方法 是 使 用 
控制 器 处 理 。 总 体 上 ， 使 用 控制 器 和 MVC 应 用 程序 模型 减轻 了 你 的 负担 ， 使 你 不 
必 处 理 路 由 和 参数 绑 定 。 但 是 ， 稍 后 将 会 看 到 ，ASPNET Core 也 是 够 灵活 ， 能 够 处 
理 服 务 叭 具有 极 催 的 结构 并 且 以 不 拘 小 节 的 方式 快速 执行 工作 的 场景 。 


1. 从 操作 方法 返回 JSON 


要 人 返回 JSON 数据 ,只 需要 在 一 个 新 的 或 者 现 有 的 Controller 类 中 创建 一 个 专用 
方法 。 对 这 个 新 方法 的 唯一 要 求 是 返回 一 个 JsonResult 对 象 。 

public IActionResult LatestNews (int count) 

{ 

var listOfNews = service.GetRecentNews (count)}); 
return Json (listoOfNews); 

} 

Json 方法 傅 保 将 给 定 对 象 打 包 到 一 个 JsonResult 对 象 中 。 从 控制 如 英 返回 
JsonResult 对 象 后 ， 当 实际 进行 序列 化 时 ， 操 作 调 用 程 厅 将 处 理 该 JsonResult 对 象 。 
束 是 这 样 而 已 。 我 们 检索 上 日 己 需 要 的 数据 , 打包 成 一 个 对 象 , 然后 传递 给 Json 方法 。 
这 束 行 了 。 全 少 ， 当 数据 是 完全 可 锌 序列 化 的 时 候 ， 工 作 束 完成 了 。 

用 来 调用 病 点 的 实际 URL 可 通过 第 用 的 路 由 方法 来 确定 ， 即 传统 路 由 和 /或 特 
性 路 由 。 


2. 返回 其 他 数据 类 型 


要 处 理 其 他 数据 类 型 ， 所 需 的 方法 并 无 不 同 。 模 式 始终 是 相同 的 ， 获 取 数据 并 
序列 化 为 格式 合适 的 字符 串 。 控 制 器 基 类 的 Content 方法 允许 序列 化 任何 文本 ， 其 
第 二 个 参数 告诉 浏览 器 准备 使 用 的 MIME 类 型。 


[HttpGetl] 
public IActionResult Todayl(int oo = 0) 
{ 
return Content (DateTime.Today.AddDays (Dj .ToSstring("d MMM yyyy"), 
"text/plain™); 
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要 返回 一 个 服务 器 文件 的 内 容 ， 例 如 一 个 要 下 载 的 PDF 文件 ,可 以 使 用 下 面 的 
代码 。 
public IActionResult Download (Int id) 
{ 
// Locate the file to download {whatever 七 hat means,) 
Var fileName = service.FindDocument (id); 


// Reads the actual content 
Var bytes = File.ReadAllBytes (fileName); 
return File (bytes, "application/pdf", fileName); 
} 
如 条 文件 保存 在 服务 右上 (例如 ， 应 用 程序 是 本 地 托管 的 )， 那 么 可 以 按 名 称 定 
位 该 文 件 。 如果 文件 被 上 传 到 一 个 数据 库 或 Azure Blob 和 存储， 那么 需要 用 字 广 流 的 
方式 获取 其 内 容 , 仍 将 其 引用 传递 给 File 方法 的 合适 重 载 。 设 置 正 确 的 MIME 类 型 
的 工作 由 你 完成 。File 方法 的 第 三 个 参数 是 下 载 的 文件 的 名 称 ( 如 图 10-1 所 示 )。 


年 http://localhost:560182/api/download/1 
芝 Programming ASP.NET Core | 忆 


Welcome to the MyAPIl demo 


De you want to open or save sample-1.pdf (148 KB) from localhost? 


图 10-1 ”从 远程 新 点 下 载 文 件 
3. 以 特定 的 格式 请 求 数 据 


在 表面 的 示例 中 ， 端 点 的 返回 类 型 是 固定 的 ， 由 运行 中 的 代码 决定 。 但 是 ， 不 
同 的 客户 端 请 求 相 同 的 内 容 是 相当 和 癌 见 的 场景 ,每 个 客户 端 有 其 首选 的 MIME 类 型 。 
我 日 己 就 经 常 过 到 这 种 场景 。 我 为 菏 个 特定 铬 尸 编写 的 大 部 分 服务 只 是 返回 JSON 
格式 的 数据 。 企 业 开 发 人 员 在 .NET 应 用 程序 、 移 动 应 用 程序 和 JavaScript 应 用 程序 
中 使 用 服务 ， 这 能 够 满足 他 们 的 需要 。 但 是 ， 有 时 一 些 冰点 还 会 被 Flash 应 用 程序 
使 用 ， 而 这 些 应 用 程序 出 于 许多 原因 首选 处 理 XML 数据 。 要 解决 这 个 问题 ， 一 种 
简单 的 方法 是 在 端点 URL 中 添加 一 个 参数 ， 该 URL 使 用 适合 你 的 需要 的 约定 ， 知 
道 期 望 的 输出 格式 。 下 向 给 出 了 一 个 例子 。 
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public IActionResult Weather (int aays = 3, string format = "json™) 


{ 
// Get weather forecasts for the specified number of days for a given city 


Var CityCode = "... 
Var jnfo = weatherSsService.GetForecasts (cityCode, days, “celsius" ); 


// Return data as regquested by the user 
it (format == "xml") 

return Content (ForecastsXmlFormatter.Serialize (info), "text/xm]l"); 
return Json (i1nfo),; 


} 
ForecastsXmlFormatter 是 一 个 月 定义 类 , 返回 一 个 日 定义 的 XML 字符 串 ， 这 个 
字符 串 是 针对 在 特定 上 下 文中 能 够 工作 的 模式 编写 的 。 


为 了 避免 使 用 魔幻 字符 串 ， 如 "json" 和 "xml"， 可 以 考虑 使 用 MediaTypeNames 
类 中 定义 的 MIME 类 型 的 常量 ,但 是 要 注意 , 在 该 类 目前 的 定义 中 ,缺少 不 少 MIME 
类 型 ， 特 别 是 application/json。 


4. 限制 动词 


在 目前 讨论 过 的 所 有 示例 中 ， 处 理 请 求 的 代码 都 是 一 个 控制 器 方法 。 因 此 ， 可 
以 使 用 控制 器 操作 方法 的 所 有 编程 特性 来 控制 参数 的 绑 定 ， 更 重要 的 是 ， 能 够 控制 
触发 代码 的 HITP 动词 和 /或 必要 的 头 或 cookies。 适 用 的 规则 就 是 第 3 章 讨论 过 的 
路 由 规则 。 人 例如， 下面 的 代码 限制 只 能 通过 GET 请 求 来 调用 api/weather 端点 。 
[HttpGet] 


public IActionResult Weather(int days = 3, string format = "json") 


{ 

} 

采用 基本 类 似 的 方式 ， 可 以 (为 JavaScript 客户 端 ) 对 来 源 URL 和 /或 同 源 安全 策 
上 略 应 用 限制 。 


重要 / 

需要 重点 注意 ， 在 本 章 的 这 一 节 ， 我 只 是 在 展示 用 非常 简单 但 是 依然 有 效 的 方 
式 来 解决 Web API 的 和 常见 问题 。 对 于 设计 和 安全 性 ， 存 在 结构 更 好 的 解决 方案 ， 本 
章 后 面 将 介绍 它们 。 


10.1.2 ”文件 服务 器 


在 我 们 重新 思考 API 设计 的 关键 方面 并 为 其 添加 安全 性 之 前 ， 先 简要 回顾 第 2 
革 给 出 的 一 个 示例 ; 一 个 极 简 网 站 。 
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1. 使 用 终止 中 间 件 来 捕捉 请 求 


第 2 草 介 绍 了 终止 中 间 件 ， 并 讨论 了 一 些 针对 它 的 值得 注意 的 用 例 。 下 面 的 代 
码 即 取 目 第 2 章 给 出 的 一 个 示例 。 
public void Configure (IApplicationBuilder app, 


IHostingEnvironment enyv, 
ICountryRepository country) 


{ 
app.Run(async (context) 三 > 
{ 
Var GueTrYy = COnteXt .RedGuest .QuUueTrv [| GdG |]; 
var listOofCountries = country.AllBy (query) .ToList (); 
Var JSson = JsonConvert.SerializeObject (listOfCountries)}); 
awalt context -Response .WriteAsync (Json); 
}); 
} 


Run 方法 就 是 终止 中 间 件 ， 它 捕 提 没有 在 其 他 地 方 处 理 的 所 有 请 求 。 例 如 ， 它 
会 捕 所 未 通过 任何 配置 的 控制 器 的 请 求 。 无 论 实际 的 疹 点 是 什么 ， 上 面 的 代码 将 得 
找 特定 的 查询 字符 串 参 数 (名 为 0， 并 根据 该 值 师 选 内 部 的 国家 列表 。 可 以 把 这 段 代 
伺 重 构 为 一 个 文件 服务 礁 。 

2. 使 终止 中 间 件 只 捕捉 示 些 请 求 

终止 中 间 件 被 设计 为 捕捉 所 有 请 求 ， 除 非 将 其 限制 到 一 些 具体 的 URL。 要 限制 
有 效 的 URL， 可 以 使 用 Map 中 间 件 方法 。 

public void Configure (IApplicationBuilder app) 

app.Map("/api/file", DownloadFile); 


} 


private static Vvoid DownloadrFile (IApplicationBuilder app) 


{ 
app.Run (async context 三 > 
{ 
var 1Q = COntLeXt .ReCuest Queryl[l"id"|]; 
VarT document = string.Format ("sample—{0}.pdf", id}); 
awalt context .Response.SendFileAsync (document).; 
}); 
} 


因为 使 用 了 Map 方法 ， 所 以 每 当 传 入 的 请 求 指向 /api/file 路 径 时 ， 代 码 会 试图 
找到 一 个 这 查询 字符 串 参数 。 然 后 ， 代 码 构建 一 个 文件 路 径 ， 并 将 其 内 容 返回 给 调 
用 方 。 

我 们 得 到 了 一 个 很 瘦 的 文件 服务 器 ， 它 能 够 智能 地 获取 存储 的 图 片 的 路 径 并 返 
回 这 些 图 片 ， 所 需要 使 用 的 代码 极 少 。 
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10.2 设计 RESTful 接口 


在 前 面 对 公 开 JSON 和 数据 端点 给 外 部 HITP 调用 方 的 讨论 中 ， 有 两 个 事实 浮 
现 了 出 来 。 首 先 ， 公 开端 点 是 很 容易 的 ， 与 公开 网 站 的 第 用 部 分 没有 什么 区 别 。 只 
人 不过， 返回 的 不 是 HIML， 而 是 JSON 或 其 他 格式 。 其 次 ， 当 公开 API 而 不 是 网 站 
时 ， 需 要 更 加 关注 服务 器 代码 的 某 些 方面 ， 并 作 一 些 更 加 深入 的 预先 思考 。 

首先 ， 必 须 以 非常 清晰 而 且 一 致 的 方式 确定 每 个 端点 需要 什么 和 提供 什么 。 这 
并 不 是 简单 地 把 URL 和 JSON 模式 记录 下 来 。 还 需要 设置 严格 的 规则 ,决定 如 何 接 
受 和 处 理 HITP 动词 和 头 ， 以 及 如 何 返 回 状态 码 。 而 且 ， 可 能 需要 在 API 上 方 添加 
一 个 授权 层 ， 用 来 验证 调用 方 的 丑 份 ， 并 检查 它 们 在 各 个 端点 上 的 权限 。 

REST 是 一 种 非常 第 用 的 方法 ， 可 将 公有 API 公开 给 客户 端的 方式 统一 起 来 。 
ASPNET Core 控制 器 文 持 一 些 额 外 的 功能 ， 使 输出 尽 可 能 RESTful。 


10.2.1 REST 简介 


REST 的 核心 理念 是 , Web 应 用 程序 (主要 是 Web APD 完 全 基于 HITP 协议 的 完 
整 功 能 集 ( 包 括 动 词 、 头 和 状态 码 ) 工 作 。REST 是 Representational State Transfer 的 和信 
写 ， 指 的 是 应 用 程序 将 以 HTTP 动词 (GET、POST、PUT、DELETE 和 HEAD) 操 作 
资源 的 形式 来 处 理 请 求 。 在 REST 中 ， 资 源 几 平 与 域 实体 完全 相当 ， 由 一 个 唯一 的 
URI 代表 。 


| * 十 荆 
三 | 壮 忌 : 
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REST 是 Web 上 的 一 种 CRUD， 处 理 的 是 由 URI 标识 的 资源 ， 而 不 是 由 主键 标 
识 的 数据 库 实体 。REST 通过 HTTP 动词 定义 操作 ， 就 像 CRUD 通过 SQL 语句 定义 
操作 一 样 。 


REST 已 经 问世 了 一 段 时 间 , 只 不 过 在 一 开始 , 它 容易 与 另外 一 个 服务 概 您 SOAP 
混 消 ，SOAP 是 Simple Object Access Protocol( 向 单 对 象 访问 协议 ) 的 简写 。REST 是 
Roy Fielding 在 2000 年 定义 的 ，SOAP 的 出 现 大 约 也 在 那 段 时 间 。REST 和 SOAP 
之 间 存 在 深刻 的 哲学 区 别 。 

e SOAP 的 目的 是 访问 隐 荐 在 Web 外观 背 后 的 对 象 ， 以 及 调用 这 些 对 和 象 的 操作 。 

SOAP 公开 了 一 组 对 象 的 可 编程 性 ， 本 质 上 是 在 执行 远程 过 程 调用 (RPC)。 

e REST 是 通过 基本 的 核心 操作 (HTTP 动词 ) 来 直接 操作 对 象 。 

考虑 到 这 种 根本 性 的 区 别 ，SOAP 的 实现 中 只 使 用 了 了 HTTP 动词 的 一 个 很 小 的 
子 集 : GET 和 POST。 
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1. HTTP 动词 的 意义 


HTTP 动词 的 含义 大 部 分 部 是 日 我 解释 的 ， 很 容易 记 住 。 它 们 将 数据 库 的 基本 
的 创建 - 谈 取 -更 新 -删除 (CRUD) 语 义 应 用 到 了 Web 资源 上 。Web 资源 在 根本 上 是 通 
过 Web API 访问 的 业务 实体 。 如 果 业 务实 体 是 一 个 预订 ， 那 么 在 特定 预订 的 URI 
上 执行 POST 命令 会 在 系统 中 新 添加 一 个 预订 。 当 介绍 ASPNET Core 控制 器 类 起 
到 的 作用 时 ， 将 对 符合 REST 的 请 求 POST、PUT、GET 等 ) 的 细节 进行 详细 介绍 。 
表 10-1 列 出 了 HTTP 动词 ， 并 对 它们 作 了 一 些 说 明 。 

表 10-1 HTTP 动词 
HTTP 动词 描述 
DELETE 发 出 请 求 来 删除 指定 的 资源 ， 这 具体 意味 着 什么 由 后 端 决定 。“ 删 除 ” 操 作 
的 实际 实现 由 应 用 程序 控制 ， 可 以 是 物理 删除 ， 也 可 以 是 他 辑 删除 
GET 发 出 请 求 来 获取 指定 资源 的 当前 表示 。 使 用 额外 的 HTTP 头 可 以 细微 调整 实 
际 的 行为 。 例 如 ， 使 用 IfModified-Since 头 时 ， 只 有 当 变 化 是 在 指定 时 间 以 
后 发 生 的 ， 才 会 收 到 响应 ， 这 可 以 减少 请 求 


HEAD 与 GET 相同， 只 不 过 返回 的 是 指定 资源 的 元 数据 ， 而 不 是 主体 。 此 命令 主要 
用 于 检查 订 个 资源 是 否 存在 

POST 发 出 添加 一 个 资源 的 请 求 ， 并 且 事 先 不 知道 URI。 此 请 来 的 REST 啊 应 会 返 
回 新 创建 的 资源 的 URI。 同 样 ，“ 添 加 资源 ”对 后 端 实际 上 意味 着 什么 要 由 
后 站 来 决定 

PUT 发 出 请 求 ， 确 保 指定 资源 的 状态 符合 提供 的 信息 。 此 命令 是 更 新 命令 的 逻辑 
对 等 命令 


对 于 传 入 (动词 和 头 ) 和 传 出 (状态 码 和 头 ) 的 内 容 , 上 面 的 每 个 请 求 都 应 该 具有 众 
所 周知 的 布局 。 


2. REST 请 求 的 结构 


我 们 来 逐个 看 看 表 10-1 中 列 出 的 动词 ， 了 解 建议 对 请 求 使 用 的 模板 (如 表 10-2 
所 示 )。 


表 10-2 REST 请 求 的 模式 
HTTP 动词 成 功 时 的 响应 
DELETE | 所 有 能 够 标识 资源 的 参数 。 例 | 对 于 啊 应 ， 有 多 个 选项 : 
如 ， 资 源 的 唯一 整数 标识 符 。 * void 吧 疙 
http://apiserver/booking/12345 这 | 。 状态 公 200 或 204 
个 请 求 是 而 望 删 除了 为 12345 的 | 。 状态 码 202， 表 示 请 求 已 被 成 功 接收 并 接 
预订 资源 受 ， 但 是 将 在 以 后 执行 
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( 续 表 ) 
HTTP 动词 请 求 成 功 时 的 响应 
GE 所 有 能 够 标识 资源 的 参数 , 以 及 | 状态 码 200。 响 应 体 包含 关于 指定 资源 状态 


可 选 的 头 ， 如 IfModified-Since 的 信息 


HEAD 同上 状态 码 200。 啊 应 体 为 宝 ， 资 源 的 元 数据 将 
作为 HITP 头 返 回 


POST 任何 与 操作 有 关 的 数据 。POST | 对 于 成 功 的 POST 操作 ， 需 要 注意 几 点 : 
操作 会 创建 一 个 新 资源 , 所 以 不 | 。 状态 个 201( 已 创建 )， 但 是 也 接受 状态 码 
需要 传递 标识 和 从 200 或 204 

。 啊 应 体 包含 对 调用 方 有 价值 的 任何 信息 

。Location HTTP 头 和 被 说 为 新 创建 的 资源 的 


URI 
PUT 所 有 人 能够 标识 资源 的 参数 , 以 及 | 对 于 啊 应 ， 有 多 个 选项 : 
与 操作 有 关 的 任何 数据 。 状态 但 为 200 或 204 


s。 void 啊 应 也 是 可 以 接受 的 


状态 码 200 表示 所 执行 的 任何 操作 都 成 功 了 。 一 般 来 说 ， 成 功 的 操作 可 能 要 求 
返回 指定 资源 的 URI。 对 于 成 功 的 POST 操作 ， 这 是 可 接受 的 ， 因 为 它 会 返回 新 创 
建 的 资源 的 URI. 但 古 ,对 于 DELETE 操作 , 束 存 在 争议 ,因为 如 果 成 功 执行 DELETE 
以 后 ， 返 回 指定 资源 的 URI， 该 URI 将 指 同 一 个 不 应 该 再 存在 的 资源 。 为 了 表示 操 
作成 功 ， 但 是 没有 啊 应 ， 可 以 返回 状态 人 码 200 和 一 个 可 选 的 空 响应 体 ; 或 者 更 精确 
的 方法 是 , 返回 状态 码 204,， 该 状态 伺 意味 看 成 功 但 是 啊 应 体 为 宇 的 啊 应 。 选择 200 
还 是 204 要 取决 于 动词 ， 但 是 在 一 定 程度 上 ， 也 是 API 设计 者 的 一 个 主观 决定 。 

发 生 钳 误 时 ， 返 回 500 或 者 一 个 更 加 具体 的 铬 误 代 码 。 如 果 找 不 到 资源 ， 束 返 
回 404。 如 果 未 获 授 权 ， 就 返回 401 或 者 更 加 具体 的 错误 代码 。 


3. 是 否 使 用 REST 


在 我 看 来 ， 是 售 使 用 REST 主要 是 一 个 哲学 问题 。 哲 学 一 般 来 说 是 很 好 的 ， 但 
是 其 具体 的 实用 性 也 取决 于 具体 环境 。 如 果 处 在 一 个 “不 生 即 死 ” 的 境地 中 ， 束 很 


难 成 为 一 个 哲学 家 。 但 是 ， 好 有 Lia 降低 陷入 “不 生 即 死 ” 境 地 的 可 能 性 。 


这 里 的 意思 是 ， 是 否 使 用 REST 完全 由 Web API 的 设计 者 来 决定 。 
REST 提供 了 一 种 干净 而 整洁 地 组 织 API 的 方式 。 但 是 ， 如 果 在 实际 的 实现 中 ， 
只 是 部 分 做 到 了 干净 整洁 ， op 上 问题， 使 得 在 其 他 地 方 做 的 整理 工作 失 
上 了 意义 。 
REST 本 身 不 是 绝对 的 好 ，RPC 本 和 映 也 不 是 绝对 的 坏 。REST 的 好 与 坏 取 决 于 
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具体 上 下 文 。 例 如 ， 如 果 计 划 设 计 一 个 公有 API 来 让 客户 购买 许可 ， 或 者 只 是 广泛 
地 使 用 该 API， 那 么 越 干 净 、 越 整洁 越 好 。 在 我 的 公司 中 ， 有 许多 Web 服务 来 运行 
业务 和 大 型 公共 事件 ， 但 是 它们 都 没有 使 用 REST。 不 过 ， 这 种 方法 是 有 效果 的 ， 
而 且 我 们 主要 在 内 部 或 者 与 合作 伙伴 一 起 使 用 这 些 Web 服务 。 
使 用 RPC 可 能 是 更 加 自然 的 选择 , 因为 其 本 映 是 业务 驱动 的 ,从 开发 的 角度 看 ， 
REST 需要 相当 多 的 提前 思考 和 纪律 ,不 过 , REST 并 不 是 能 够 立即 解决 问题 的 魔杖 。 
相 比 RPC，REST 还 有 两 个 考虑 因素 。 
e 一 个 是 超 媒体 ,这 种 想法 是 让 HTTP 啊 应 返回 一 个 额外 的 字段 (名 为 links)， 指 
定 当 接 收 到 啊 应 以 后 可 以 采取 的 进一步 操作 。 因 此 , 超 媒体 问 客 户 端 提供 了 
下 一 步 可 以 执行 的 操作 的 信息 。 
e REST 的 男 一 个 考虑 因素 可 能 对 客户 病 产 生 积极 影响 :REST 期 望 HTTP 啊 
应 声明 其 可 缓存 性 。 


10.2.2 在 ASPNET Core 中 使 用 REST 


在 ASPNET Core 之 前 ,Microsoft 设计 了 Web API 框 架 ,专门 用 于 构建 Web APL， 
对 RESTful Web API 提供 了 完整 的 编程 文 持 。Web API 框架 并 没有 完全 集成 到 瓜 层 
的 ASPNET 省 道 ， 当 请 求 被 路 由 到 这 个 框架 后 ， 必 须 经 过 一 个 专用 的 害 道 。 在 
ASPNET MVC 5.x 应 用 程序 的 上 下 文中 使 用 Web API 可 能 是 也 可 能 不 是 一 个 合理 的 
决定 。 使 用 ASPNET MVC 5.x 控制 器 (甚至 RESTful 接口 ) 可 以 实现 相同 的 目标 ， 只 
是 并 没有 内 置 的 设置 来 帮助 实现 RESTful。 因 此 ， 是 否 做 到 RESTful 由 你 自己 决定 ; 
你 需要 添加 额外 的 代码 来 匹配 表 10-2 中 的 要 求 。 

在 ASPNET Core 中 ， 没 有 独立 的 、 专 用 的 Web API 框架 。 有 的 只 是 控制 器 (有 
其 自己 的 一 组 操作 结果 和 帮助 程序 方法 )。 如 果 想 要 构建 一 个 Web API， 只 需要 返回 
JSON、XML 或 前 面 讨论 过 的 其 他 内 容 。 如 果 想 构建 一 个 RESTful API， 束 要 熟悉 另 
外 一 组 操作 结果 和 帮助 程序 方法 。 


1. RESTful 探 作 结 果 


第 4 草 已 经 给 出 了 与 Web API 相关 的 操作 结果 类 型 的 完整 列表 。 下 向 用 一 个 表 
格 展 示 了 操作 结果 ， 并 投 照 执行 的 核心 操作 对 它们 进行 了 分 组 (如 表 10-3 所 示 )。 


表 10-3 与 Web API 相关 的 IActionResult 类 型 


类 型 摘 述 
AcceptedResult 返回 202 状态 但， 并 设置 要 检查 的 URI， 以 全 获知 请 来 
的 当前 状态 
BadRequestResult 返回 400 状态 但 


245 


246 


第 IV 部 分 前 端 


( 续 表 ) 
类 型 摘 述 
CreatedResult 返回 201 状态 码 ， 以 及 创建 的 资源 的 URI( 在 Location 头 
中 设置 ) 
NoContentResult 返回 204 状态 码 和 null 内 容 
OkResult 返回 200 状态 公 
UnsupportedMediaTypeResult 返回 415 状态 码 


可 以 看 到 , 操作 结果 类 型 准备 的 啊 应 与 表 10-2 中 描述 的 典型 的 REST 行 为 相符 。 
表 中 的 一 些 关 型 有 一 些 兄 弟 撩 型， 提供 了 稍 有 不 同 的 行为 。 例 如 ， 对 于 202 和 201 
状态 但， 存在 3 种 不 同 的 操作 结果 。 

除了 AcceptedResult 和 CreatedResult， 还 有 xxxAtActionResult 和 xxARouteResult 类 
型 。 区 别 在 于 这 些 类 型 表达 URI 的 方式 ， 当 指定 了 URI 以 后 ,就 可 以 监控 已 经 接受 
的 操作 的 状态 ， 以 及 刚 创 建 的 资源 的 位 置 。xxxAtActionResult 类 型 用 一 个 控制 右 和 
操作 字符 串 对 的 形式 表达 URI， 而 xxxAtRouteResult 类 型 则 使 用 一 个 路 由 名 称 。 

其 他 一 些 操 作 类 型 有 一 个 xxxObjectResult 变 体 。 OkObjectResult 和 
BadRequestObjectResult 是 两 个 很 好 的 例子 。 区 别 在 于 ， 对 象 结果 类 型 还 允许 在 啊 应 
中 进 加 一 个 对 象 。 例 如 ，OkResult 只 是 设置 200 状态 码 ， 而 OkObjectResult 除了 设 
并 200 状态 码 ， 还 会 奶 加 一 个 你 选择 的 对 象 。 此 功能 音 被 用 于 当 收 到 有 问题 的 请 求 
时 ， 返 回 一 个 用 检测 到 的 销 误 更 新 过 的 ModelState 字典 。NotFoundObjectResult 是 
态 外 一 个 例子 ， 扎 可 以 设置 请 求 的 当前 时 间 。 

最 后 ，NoContentResult 和 EmptyResult 之 间 也 有 一 个 值得 注意 的 区 别 。 二 者 都 
退回 一 个 宝 啊 应 ， 但 是 NoContentResult 设 管状 态 公 204， 而 EmptyResult 设置 状态 
码 200。 


2. 党 用 操作 的 基本 骨 琳 


接 下 来 ,我们 基于 ASPNET Core 的 控制 器 ， 讨 论 一 个 RESTAPI 的 代码 。 示 例 
控制 占有 一 个 代表 新 闻 的 资源 ， 下 和 面 的 代码 显示 了 如 何 编 号 GET、DELETE、POST 
和 PUT 操作 。 


[HttpPost| 

public CreatedResult AddNews (News news) 

{ 
// Do something here to save the news 
Var newslId = SaveNewslInSomeWay (news); 


// Returns HTTP 201 and sets the URI to the Location header 
Var relativePath = String.Format ("/api/news/{0}", newsId);} 
return Created (relativePath, news); 
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} 
[HttpPutl 
public AcceptedResult UpdateNews (Guid id, string title, string content) 
{ 
// Do something here to update the news 
Var news = UpdateNewsInSomeWay (ld, title, content); 
Var relativePath = String.Format ("/api/news/{0}", news.NewsId); 
return Accepted (new Uri (relativePath)); 
} 
[HttpDeletel 
public NoCcontentResult DeleteNews (Guid 1d) 
{ 
// Do something here to delete the news 
J 
return NoContent (); 
} 
[HttpGetl] 
public ObjectResult Get (Guid id) 
{ 
// Do something here to retrieve the news 
Var news = FindNewslInSomeWay (1d); 
return Ok (news); 
} 


所 有 的 返回 类 型 都 派生 日 IActionResult, 实际 的 实例 是 使 用 Controller 基 关 公开 
的 一 个 专门 的 帮助 程序 方法 创建 的 。 需 要 注意 的 是 ， 相 比 以 前 的 Web API， 在 
ASPNET Core 中 , 控制 器 帮助 程序 方法 通过 完成 大 部 分 第 见 的 REST 任务 ， 让 工作 
变 得 更 加 简单 。 事 实 上 ， 如 果 奏 看 CreatedResult 类 的 源 代 公 ， 会 看 到 下 和 耐 的 代 公 : 


// Invoked from the base class ObjectResult 
public override void OnFormatting (ActionContext context) 


{ 
if (context == null) 
throw new ArgumentNullException("context™").; 
base.OnFormatting (context); 
context .HttpContext .Response.Headers|[|"Location"|] = (StringValues,) 
this.Location; 
} 


在 Web API 中 ， 这 种 代码 大 部 分 都 需要 我 们 自己 编写 。 在 让 控制 器 类 更 加 
RESTful 方面 ，ASPNET Core 表现 得 于 好 。 要 人 夯 看 ASP.NET Core 中 与 Web API 
有 关 的 类 的 源 人 代码， 可 访问 http://github.com/aspnet/Mvc/blob/dev/src/Microsoft. 
AspNetCore.Mvc.Core 文件 夹 。 
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3. 内 容 协 商 


内 容 协商 是 ASPNET Core 控制 圳 的 一 项 功能 , 而 ASPNET MVC 5 控制 如 并 不 
支持 它 。 引 入 内 容 协 商 是 为 了 满足 Web API 框架 的 需要 。 在 ASPNET Core 中 ， 内 
容 协 商 被 内 置 到 引擎 中 , 供 开 发 人 员 使 用 。 顾名思义 , 内 容 协 商 指 的 是 调用 方 和 API 
之 间 悄悄 发 生 的 协商 。 协 商会 考虑 返回 数据 的 实际 格式 。 

如 采 传 入 的 请 求 包含 一 个 Accept 尖 ,， 说 明了 调用 方 可 以 理解 的 MIME,， 那么 就 
要 考虑 内 容 协 商 。ASPNET Core 中 的 默认 行为 是 将 任何 返回 对 象 序 列 化 为 JSON。 
例如 ， 在 下 面 的 代码 中 ，News 对 象 将 被 序列 化 为 JSON， 除 非 内 容 协商 决定 使 用 另 
一 种 格式 。 

[HttpGet] 

public ObjectResult Get (Guid id) 

| // Do something here to retrieve the news 

var news = FindNewsInSomeWay (id); 


return Ok (news); 

} 

如 有 果 控 制 闫 检测 到 Accept 头 ， 那么 就 会 扫描 涉 内 容 中 列 出 的 闫 型 ， 直到 找到 目 
己 可 以 提供 的 格式 。 这 种 扫描 遵循 的 是 MIME 类 型 出 现 的 顺序 上。 如 果 没 有 找到 控制 
做 能 够 文 持 的 类 型 ， 了 怠 使 用 JSON。 

注意 ， 如 果 传 入 的 请 求 包 含 Accept 头 ， 并 且 欣 制 右 上 友 回 的 啊 应 是 ObjectResult 
类型 ， 则 会 触 友 内 容 协商 。 如 果 序 列 化 控制 器 的 啊 应 (例如 使 用 了 Json 方法 )， 那 么 
不 管 是 不 是 发 送 J Accept 头 ， 都 不 会 发 生 内 容 协 商 。 


注意 : 

另 一 个 操作 结果 类 型 UnsupportedMediaTypeResult 看 起 来 与 内 容 协 商 有 一 定 
关系 。 处 理 这 个 操作 结果 将 返回 HTTP 状态 码 415， 意 味 着 发 送 了 Content-Type 
头 Accept 之 外 的 一 个 HITP 头 一 一 来 描述 请 求 的 内 容 。 例 如 ，Content-Type 
头 指定 了 上 传 的 图 片 文 件 的 实际 格式 。 如 果 控制 器 不 支持 该 内 容 类 型 (例如 ， 服 
务 器 不 支持 上 传 的 PNG 文件 )， 就 可 能 返回 状态 码 415。 考 上 谍 到 这 一 点 ， 
UnsupportedMediaTypeResult 类 型 实际 上 并 不 与 内 容 协 商 相 关 。 


10.3 ”保护 Web API 的 安全 


保护 Web 应 用 程序 要 比 保 护 通过 HTTP 公开 的 API 简单 .Web 应 用 程序 由 Web 
浏览 器 使 用 ， 而 Web 浏览 器 很 容易 处 理 cookie。 在 ASPNET Core 中 ， 操 作 方 法 上 
的 Authorize 特性 告诉 运行 时 ， 只 有 经 过 身份 验证 的 用 户 才能 调用 该 方法 。 在 
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ASPNET Core( 以 及 任意 的 Web 应 用 程序 ) 中 ，cookie 是 存储 和 转发 用 户 喘 份 信息 的 
主要 方式 。 对 于 在 Web 上 公开 的 API， 还 需要 考虑 其 他 场景 。 客 户 端 可 能 是 桌面 应 
用 程序 ， 但 更 可 能 是 移动 应 用 程序 。 突 然 之 间 ，cookie 不 再 是 一 种 有 效 的 方式 ， 既 
不 能 保护 API 的 安全 ， 又 不 能 使 API 被 尽 可 能 多 的 客户 病 使 用 。 

总 体 上 ， 我 把 Web API 的 安全 选项 分 为 两 大 类 : 简单 但 在 一 定 程 度 上 有 效 的 方 
法 和 最 佳 实践 方法 。 


10.3.1 只 计划 真正 需要 的 安全 性 


安全 性 是 一 个 严肃 的 问题 ， 不 是 吗 ? 那么 ， 为 什么 有 时 要 考虑 不 是 最 佳 实 践 的 
方法 ? 原因 在 于 ， 安 全 性 对 于 不 同人 的 含义 有 可 能 不 同 。 安 全 性 不 是 一 种 功能 性 需 
求 ， 其 重要 性 会 根据 上 下 文 发 生变 化 。 我 的 某 些 生产 环境 中 的 Web API 就 根本 没有 
授权 层 ， 任 何人 只 要 能 够 找 出 这 些 API 的 URL， 惑 能 够 调用 它们 。 我 还 有 另外 一 些 
Web API 实现 了 非 稍 基本 的 访问 控制 层 ， 这 对 于 可 以 想见 的 大 部 分 场景 都 够 用 了 。 
最 后 ， 我 还 有 几 个 Web API， 对 它们 使 用 了 访问 控制 的 最 佳 实践 。 

简单 但 在 一 定 程 度 上 有 效 的 方法 和 最 佳 实践 方法 之 间 的 取舍 点 在 于 实现 最 佳 实 
践 安 全 性 所 需 的 时 间 和 成 本 。 拥 有 并 通过 API 分 享 的 数据 的 重要 性 对 于 做 出 这 个 决 
定 公关 重 要 。 如 果 一 个 API 是 只 读 的 ， 只 分 享 公 有 或 非 敏感 数据 ， 那 么 从 访问 控制 
的 角度 看 ， 造 成 问题 的 可 能 性 要 小 得 多 。 

关于 这 一 点 ， 我 想 分 享 一 个 趣事 ， 它 发 生 在 我 近期 讲授 的 ASPNET MVC 课程 
的 课堂 上 。 在 讲 到 ASPNET MVC 安全 模块 的 时 候 ， 一 个 听 读 人 问 我 ， 他 为 什么 需 
要 使 用 我 讲 的 这 一 大 堆 主 体 、 角 色 、 声 明 、 令 有 牌 等 。 我 礼貌 地 指出 ， 这 要 视 数 据 的 
重要 性 而 定 。 他 的 回答 让 我 笑 了 ， 但 是 确实 能 够 说 明 这 里 的 要 点 。 他 说 :“ 在 我 的 应 
用 程序 中 , 最 坏 的 情况 束 是 有 人 但 看 了 其 他 人 的 奶牛 的 照 厂 ,不 算 什 么 大 事 。” 的 确 ， 
我 非常 同 总 ! 


在 受到 访问 控制 的 操作 方法 上 使 用 Authorize 特性 对 于 Web API 是 有 作用 的 ， 
但 是 只 能 要 求 通过 Web 浏览 器 客户 端 连接 的 用 户 证 明 其 身份 。 如 果 用 户 通 过 移动 应 
用 程序 或 果 面 应 用 程序 访问 API， 就 必须 找到 一 种 方式 来 支持 cookie。 Windows 确 
实 有 一 些 API 可 用 于 此 用 途 ， 而 在 移动 应 用 程序 中 ， 可 以 通过 一 些 专用 的 网 络 来 建 
立 连接 ,这 些 专用 的 网 络 基本 上 就 是 使 用 Web 视图 来 处 理 cookie。 保护 API 的 关键 
是 找 出 一 种 统一 的 方法 一 一 不 基于 cookie， 同 时 仍然 保证 能 够 检测 用 户 的 身份 。 
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10.3.2 ”较为 简单 的 访问 控制 方法 


我 们 接 下 来 讨论 的 一 些 选项 可 在 Web API 之 上 添加 一 个 访问 控制 层 。 这 些 方法 
都 不 完美 ， 但 是 也 都 不 是 完全 没有 效果 。 


1. Basic 身份 验证 


要 在 Web API 中 加 入 访问 控制 ,最 简单 的 方法 是 使 用 Web 服务 器 中 内 置 的 Basic 
身份 验证 。Basic 身份 验证 基于 的 思想 是 : 每 个 请 求 中 都 打包 了 用 户 的 凭据 。 

Basic 吴 份 验证 有 其 优点 和 缺点。 优点 是 ，Basic 身份 验证 得 到 了 主流 浏览 器 的 
文 持 ， 是 一 种 Internet 标准 ， 并 且 易 于 配置 。 缺 点 是 ， 和 凭据 会 随 看 每 个 请 求 友 达 ， 
更 糟 的 是 ， 和 凭据 是 作为 明文 发 送 的 。 

Basic 号 份 验证 期 理 的 是 ， 发 送 的 凭据 在 服务 器 冰 验 证 。 只 有 和 凭据 有 效 ， 才 接受 
请 求 。 如 果 请 求 中 不 包含 凭据 ， 则 将 显示 一 个 交互 式 对 话 框 。 现 实 中 ，Basic 有 身份 验 
证 还 需要 某 种 专门 的 中 同 件 ， 根 据 某 个 数据 库 中 存储 的 账户 来 验证 凭据 。 


注意 : 
当 与 一 个 对 凭据 进 行 自 定义 验证 的 层 结 合 起 来 时 ,Basic 身份 验证 会 非常 简单 又 
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非常 有 效 。 为 了 克服 凭据 作为 明文 发 送 这 个 局 限 ， 应 该 总 是 在 HITPS 上 实现 Basic 
身份 验证 解决 方案 。 


2. 基于 令 牌 的 身份 验证 


这 种 方案 的 思想 是 ，Web API 接收 一 个 访问 令 牌 ( 通 利 是 GUID 或 一 个 字母 数字 
字符 串 )， 然 后 验证 这 个 令 秩 。 如 果 该 令 牌 未 过 期 ， 且 对 于 应 用 程序 是 有 效 的 ， 残 处 
理 请 求 。 有 多 种 方式 可 发 放 令 牌 。 最 侧 单 的 方法 是 线 下 发 放 令 和 胜 ， 即 当 客 户 联 系 公 
司 来 获取 API 的 许可 时 ， 创 建 令 牌 并 将 其 与 这 个 特定 的 客户 关联 起 来 。 之 后 ，API 
若 被 滥用 或 误 用 , 都 是 客户 的 责任 。 服 务 器 端的 方法 只 有 在 识别 了 令 牌 后 才 会 工作 。 

Web API 后 端 需要 有 一 个 检查 令 牌 的 层 。 可 以 把 这 个 层 作 为 普通 代码 添加 到 任 
何方 法 中 ， 或 者 更 好 的 方法 是 ， 将 其 配置 为 应 用 程序 中 间 件 的 一 部 分 。 令 牌 可 以 妃 
加 到 URL 中 (例如 ， 作 为 租 询 字符 串 参 数 )， 或 者 作为 HITP 头 舱 入 请 求 中 。 这 些 方 
法 都 不 完美 ， 但 是 也 没有 更 加 安全 的 方法 。 在 这 两 种 情况 中 ， 念 牌 的 值 都 可 能 被 军 
探 。 使 用 头 相 对 来 说 是 更 好 的 方法 ， 因 为 在 URL 中 不 会 一 眼看 到 HTTP 头 。 

为 了 加 固 防 御 ， 可 以 对 令 牌 使 用 某 种 严格 的 过 期 策略 。 不 过 ， 总 的 来 说 ， 这 种 
方法 的 优点 是 ， 你 始终 知道 谁 应 该 为 滥用 或 误 用 API 负责 ， 并 且 能 够 在 任何 时 候 禁 
用 令 脾 ， 阻 止 他 们 的 瀑 用 或 误 用 行为 。 
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3. 额外 的 访问 控制 障碍 


除了 前 和 面 的 方法 之 外 (或 者 作为 它们 的 蔡 代 方法 )， 仍 然 可 以 只 处 理 来 目 指 定 
URL 和 /或 IP 地 址 的 请 求 。 在 控制 堪 方 法 内 ， 可 以 使 用 下 面 的 表达 式 ， 检 碍 请 求 来 
自 哪个 卫 地 址 : 


Var ip = HLtPConteXxt .Connection.RemoteIpAddress;} 


但 是 要 注意 ， 如 果 应 用 程序 位 于 负载 平衡 器 (如 Nginx) 的 后 耐 ， 那 么 获取 他 地 
址 可 能 会 哆 加 困难 ， 需 要 一 些 回 退 远 辑 来 检查 和 人 处理 X-Forwarded-For HTTP 头 。 

原始 的 URL 通常 在 referer HTTP 头 中 设置 , 该 头 指 出 了 用 户 在 发 出 请 求 前 所 在 
的 最 后 一 个 页 面 。 可 以 指定 ， 只 有 当 referer 头 包 含 特定 的 值 时 ，Web API 才 处 理 请 
求 。 不 过 ， 专 门 的 机 器 人 能 够 轻松 地 设置 HITP 头 。 

一 般 来 说 ， 检 全 IP 地 址 和 /或 HITP 头 ( 如 referer， 甚 全 user-agenb 这 样 的 扩 术 
主要 是 将 安全 的 标准 提 得 越 来 越 高 。 


10.3.3 ”使 用 身份 和 绾 理 服 务 器 


一 般 来 说 ， 和 号 份 宵 理 服务 占 位 于 许多 应 用 程序 和 组 件 的 中 间 ， 并 外 包 喘 份 服 
务 。 换 句 话 说 ， 不 是 在 内 部 建立 身份 验证 逻辑 ， 而 是 配置 一 个 身份 管理 服务 器 ， 
让 它 来 完成 验证 身份 的 工作 。 在 Web API 中 ， 身 份 服务 器 能 够 在 配置 的 、 相 关 的 
API 和 访问 控制 之 间 提 供 单 点 登录 。 在 ASPNET Core( 以 及 经 典 ASPNET) 中 ,Identity 
Server 是 流行 的 选择 。ASPNET Core 需要 使 用 Identity Server 4( 参 见 http:/www. 
identityserver.com)。ldentity Server 是 一 个 开源 产品 ,实现 了 OpenID Connect 和 OAnuth 
协议 。 在 这 个 方面 , 它 是 一 个 极 好 的 工具 , 可 以 把 访问 控制 委托 给 它 来 保护 Web API 
的 安全 。 在 本 章 的 剩余 部 分 ， 我 们 将 讨论 用 于 ASPNET Core 的 Identity Server 4。 


[ 


= |] 注意 : 

一 ) 使 用 身份 服务 器 来 控制 对 Web API 的 访问 的 优势 在 于 ， 仍 然 使 用 Authorize 特 
性 标记 操作 方法 ， 但 不 会 使 用 cookie 来 提供 用 户 的 身份 。Web API 收 到 (并 检查 ) 作 
为 HTTP 头 传 入 的 授权 令 牌 。 当 允许 用 户 的 数据 访问 Web API， 并 使 用 用 户 的 数据 
配置 了 选 定 的 Identity Server 实例 后 ， 该 实例 就 会 设置 令 牌 的 内 容 。 由 于 不 涉及 
cookie， 因 此 使 用 Identity Server 保护 的 Web API 能 够 轻松 地 处 理 移动 应 用 程序 、 呆 
面 应 用 程序 和 任何 现 有 的 或 未 来 的 HITP 客户 端 。 


1. 为 使 用 Identity Server v4 做 好 准备 


图 10-2 从 整体 上 显示 了 Identity Server 如 何 与 Web API 及 其 启用 的 客户 端 进行 
交互 。 
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Identity Server 必须 是 一 个 专用 的 目 托 管 应 用 程序 ， 在 ASPNET Core 中 ， 可 以 
通过 Kestrel 或 者 反问 代理 直接 公开 。 无论 如 何 ， 需 要 一 个 广为人知 的 HITP 地 址 来 
联系 服务 器 。 公 正 来 说 , 需要 使 用 一 个 广为人知 的 HITPS 地 址 来 联系 Identity Server。 
HTTPS 为 通过 网 络 交 换 的 内 容 添加 了 隐私 性 。Identity Server 提供 了 访问 控制 ， 但 
是 在 现实 应 用 中 ， 应 该 总 是 在 身份 服务 堆 上 使 用 HITPS。 

图 10-2 显示 ，Identity Server 最 好 与 API 是 不 同 的 应 用 程序 。 为 了 全 和 面 进行 演 
示 ， 我 们 将 使 用 三 个 不 同 的 项 目 一 一 一 个 托管 Identity Server， 一 个 托管 Web API 
示例 ， 还 有 一 个 模拟 客 尸 问 应 用 程序 。 


2. 身份 验证 


移动 应 用 程序 


”+ 芝 一 此 A 
想 要 使 用 MyADPI 2 而 求 令 租 


图 10-2 ”使 用 Identity Server 保护 的 Web API 
2. 构建 Identity Server 的 宿主 环境 


为 托管 Identity Server， 首 先 创 建 一 个 全 新 的 ASPNET Core 项 目 ， 并 添加 
IdentityServer4 NuGet 包 。 如 果 已 经 在 使 用 ASPNET Identity( 人 参见 第 8 章 的 介绍 )， 那 
么 还 应 该 添加 IdentityServer4.AspNetIdentity。 根 据 实 际 局 用 的 功能 ， 可 能 还 需要 添 
加 其 他 的 包 。 局 动 类 如 下 所 示 ( 后 和 耐 将 解释 Config 方法 )。 


public class Startup 

{ 
Public void ConfiqureServices (lIServiceCollection services) 
{ 

Services.AddIidentityServer() 
.AddDeveloperSigningCredent1ial () 
.AddInMemoryApiResources (Config.GetApiResources ()) 
-AddInMemoryClients (Config.GetClients () ); 

} 


public void Configure (IApplicationBuilder app, IHostingEnvironment enyv) 
{ 

app .UseDeveloperExceptionPage (); 

app.UseldentityServer (); 


app.Run (async (context) 三 > 
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awalt ConteXt .ReSspPponse -WT1IteASYnC 
"Welcome to Identity Server — Pro ASP-NET Core book™); 


} 

图 10-3 显示 了 将 看 到 的 主页 。 现 在 ， 服 务 堪 没有 器 点 ， 也 没有 用 户 界 向 ， 但 是 
添加 管理 员 用 户 界 面 来 修改 配置 是 你 的 工作 。 对 于 Identity Server 4， 已 经 有 一 个 
AdminUI 服务 插件 可 用 (请 访问 http://www.identityserver.com)。 


也 http://localhost:6000/ ~ GO | Search... 


悍 localhost | 名 


Welcome to Identity Server - 
Pro ASP.NET Core book 


图 10-3 ”运行 中 的 Identity Server 实例 
接 下 来 ， 我 们 评 细 介绍 服务 占 的 配置 参数 ， 上 基体 来 说 包括 客 尸 端 、APTI 资源 和 
3. 向 Identity Server 添加 客户 端 


客户 端 列 表 指 的 是 获准 连接 Identity Server 并 访问 其 保护 的 资源 和 API 的 客户 
疹 应 用 程序 。 必 须 配 置 每 个 客户 端 应 用 程序 ， 说 明 人 允许 它 做 什么 以 及 怎么 做 。 例 如 ， 
可 以 限制 一 个 客户 端 应 用 程序 ， 使 其 只 能 调用 某 个 API 的 一 部 分 。 至 少 ， 需 要 为 客 
户 端 应 用 程序 配置 一 个 DD 和 一 个 密码 ， 以 及 授权 类 型 和 范围 。 


public class Confjig 

{ 
Public static IEnumerable<Client> GetClients () 
{ 


return new List<Client»> 


{ 


new Client 
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ClientId = "contoso"™, 
ClientSecrets = { 
new Secret ("contoso-secret".Sha?256()) 
}, 
AllowedGrantTypes = GrantTypes.ClientcCcredentials, 
AllowedSscopes = { Weather-API” } 


}s 
} 


如 有 果 你 曾经 使 用 过 社交 网 络 API， 那 么 可 能 会 熟悉 ID 和 和 密码。 例如， 要 访问 
Facebook 的 数据 ， 首 先 要 创建 一 个 Facebook 应 用 程序 ， 并 用 两 个 字符 串 完全 标识 
这 个 应 用 程序 。 在 Identity Server 中 ， 把 这 两 个 字符 串 分 别称 为 ID 和 密码 。 授 权 类 
型 说 明了 允许 客户 端 如 何 与 服务 器 交互 ,一 个 客户 端 应 用 程序 可 以 有 多 个 授权 类 型 。 
需要 注意 的 是 ， 这 里 的 客户 靖 应 用 程序 与 运行 一 个 实际 的 应 用 程序 不 同 。 实 际 上 ， 
这 里 讨论 的 客户 痛 应 用 程序 是 一 个 OpenID Connect 和 OAnuth2 概念 。 例 如 ， 一 个 具 
体 的 移动 应 用 程序 和 一 个 实际 的 网 站 可 以 使 用 相同 的 客户 姗 应 用 程序 来 访问 
Identity ServeT。 

如 果 想 要 你 护 一 个 Web API， 通 第 需 要 使 用 ClientCredentials， 这 意味 看 对 于 单 
独 的 用 户 ， 并 不 是 必须 要 有 请 求 令 脾 ， 只 有 对 于 客户 端 应 用 程序 ， 请 求 令 牌 才 是 必 
需 的 。 换 句 话 说 ， 作 为 Web API 的 所 有 者 ， 要 问 客 户 问 应 用 程序 及 其 所 有 的 个 人 用 
尸 授予 访问 权限 。 不 过 ， 一般 来 说 ，Identity Server 可 用 来 针对 每 个 用 户 进 行 访 问 控 
制 , 这 束 需 要 有 多 个 授权 类 型 , 其 全 需要 同一 个 客户 病 应 用 程序 共有 多 个 授权 类 型 。 
除了 在 服务 器 之 间 的 通信 中 保护 Web API， 还 有 其 他 的 场景 ， 关 于 这 些 场景 的 更 多 
信息 ， 可 访问 http://docs.identityserver.io/en/release/topics/grant types.html。 

当 使 用 了 ClientCredentials 选项 时 ， 得 到 的 流程 与 图 10-2 完全 相同 。 当 实际 的 
应 用 程序 需要 调用 受 保护 的 API 时 ， 首 先 问 Identity Server 的 令 牌 端点 发 送 一 个 令 
牌 请 求 。 在 这 么 做 的 时 候 , 实际 的 应 用 程序 会 使 用 配置 的 某 个 Identity Server 客户 疹 
的 凭据 QD 和 密码 )。 如 果 身份 验证 成 功 ， 实 际 的 应 用 程序 会 获得 一 个 访问 令 牌 ， 代 
表 要 传递 给 Web API 的 客户 端 ( 稍 后 详细 介绍 )。 


4. 向 ldentity Server 添加 API 资源 


一 般 来 说 ，API 资源 指 的 是 想 要 进行 保护 ， 使 之 避免 受到 未 授权 访问 的 资源 ( 例 
如 Web APD。 有 具体 来 说 ，API 资源 只 是 一 个 在 Identity Server 中 标识 Web API 的 标 
签 。API 资源 由 一 个 键 和 一 个 显示 名 构成 。 通 过 API 资源 ， 客 户 端 应 用 程序 可 设置 
其 范围 , 方式 与 在 Facebook 应 用 中 声明 想 要 访问 的 用 户 的 声明 相同 。 声 明 感 兴趣 的 
API 资源 可 防止 客户 端 应 用 程序 访问 不 在 范围 内 的 任何 Web API 或 者 Web API 的 茶 
个 部 分 。 回 Identity Server 注册 时 ，Web API 会 声明 自己 处 理 的 资源 。 
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public class Config 


{ 
Public static IEnumerable<ApiResource> GetApIResourcCesS () 
{ 
return new List<ApiResource> 
| 
new Ap1LIResource ( un-AaPI ， 
"My API Just for test and un ”) 
new AplilResource( Weather-API…， 
"My fabulous weather API™"), 
}; 
} 
| 


上 面 的 代码 将 Identity Server 配置 为 文 持 两 种 资源 : fun-API 和 weather-API。 前 
而 定义 的 客户 问 应 用 程序 只 对 weather-API 感 兴趣 。 


5. 客 己 端 和 资源 的 持久 化 


在 这 里 讨论 的 示例 中 ， 我 们 使 用 了 廊 态 定义 的 客户 疡 和 资源 。 虽 然 在 攻 些 部 壮 
的 应 用 程序 中 ， 可 能 会 出 现 这 种 场景 ， 但 是 其 实 不 怎么 符合 现实 应 用 。 如 果 在 一 个 
封闭 的 环境 中 能 够 控制 所 有 组 件 ， 并 且 当 某 个 地 方 必 须发 生 改 变 ， 需 要 使 用 一 个 新 
的 资源 或 莉 的 客户 疾 时 ， 能够 重新 编译 和 各 新 部 车 API、 服 务 如 和 实际 的 应 用 程序 ， 
那么 使 用 静态 定义 的 客户 关 和 资源 可 能 是 合理 的 。 

但 是 ， 更 可 能 出 现 的 情况 是 ， 和 客户 病 和 资源 是 从 茶 个 持久 存储 中 加 载 的。 实现 
方式 有 两 种 。 一 种 是 编写 目 己 的 代码 来 获取 客户 站 和 资源 ， 并 把 它们 作为 内 存 对 象 
传递 给 Identity Server。 男 一 种 方法 则 利用 Identity Server 内 置 的 基础 结构 。 

services.AddIdentitySserver () 


-AddDeveloperSigningCredential () 
-AddConfigurationstore (options => 


{ 
options.ConfigureDbContext = builder 三 > 
builder.UseSqlServer("connectionSstring...", 
Sql => sql.MigrationsAssembly (migrationsAssembly)); 
a 


如 有 果 选 择 这 种 方法 ， 则 需要 迁移 来 传递 数据 库 的 架构 ， 然 后 将 悄悄 创建 数据 
奋 。 要 创建 迁移 程序 集 ， 需 要 运行 专门 的 命令 ， 它 们 包含 在 男 外 一 个 NuGet 包 
IdentityServer4.EntityFramework 中 ， 所 以 还 需要 安装 这 个 NuGet 包 。 最 后 ， 注 总 出 
于 性 能 的 原因 ，Identity Server 还 提供 了 一 个 插入 绥 存 组 件 的 机 会 。 在 这 种 情况 中 ， 插 
入 的 组 件 实现 指定 的 接口 束 足 够 了 了, 而 不 管 为 了 保存 数据 , 搬 层 实际 使 用 了 什么 技术 。 


注意 : 
要 想 全 面 了 解 在 持久 化 和 签名 方面 有 什么 选项 可 用 ， 请 访问 http://docs. 
1dentityserver.10/en/release/quickstarts/8 entity framework.html, 
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6. 签名 凭据 


在 上 面 的 启动 代码 中 可 以 看 到 , AddDeveloperSisningCredential 方法 用 于 创建 一 
个 临时 键 ， 这 个 键 用 来 对 作为 身份 证 明 返 回 的 令 牌 进行 签名 。 如 果 在 第 一 授 运 行 后 
丛 看 项 目 ， 会 看 到 项 目 中 添加 了 一 个 名 为 tempkey.rsa 的 JSON 文件 。 


{ "KeYIQ":"C789 . "Parameters™:{"D":"ndm8...",...}} 


虽然 对 于 练习 ， 这 行 代码 很 方便 ， 但 是 在 生产 场景 中 ， 需 要 将 其 蔡 换 为 一 个 持 
久 刍 或 任 握 。 现 实 中 ， 需 要 在 攻 个 时 候 ( 可 能 是 在 检查 了 当前 en gels mil 
AddSisningCredential。AddSigningCredential 方法 添加 一 个 签名 键 服务 ， 访 服务 获取 
AddDeveloperSieningeCredential 从 持久 存储 动态 创建 的 键 信息 。 AddSignineCredential 
方法 可 接受 多 种 格式 的 数字 签名 。 签 名 可 以 是 义 509Certificate2 类 型 的 对 象 , 也 可 以 
是 对 证 书 存 储 中 的 茶 个 证 书 的 引用 。 


AddIidentityServer() 
-AddsigningCredentjal ("CN=CERT SIGN TEST CERT™); 


它 还 可 以 是 SigningCredentials 类 或 RsaSecurityKey 的 实例 。 


\ \ 十 = 
三 | 壮 忌 : 
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要 想 全 面 了 解 有 哪些 签名 选项 可 用 ,请 访问 http://docs.identityserver.io/en/release/ 
topics/crypto.html. 


7. 使 Web API 适应 Identity Server 


全 此 ， 服 务 闫 已 经 运行 ， 准 备 好 控制 对 API 的 访问 了 。 但 是 ，Web API 仍然 缺 
少 一 层 人 代码， 让 自己 与 Identity Server 连接 起 来 。 要 通过 Identity Server 添加 授权 ， 
需要 两 个 步 又。 首先 ， 需 要 添加 IdentityServer4.AccessTokenValidation 包 。 这 个 包 
会 添加 必要 的 中 间 件 来 验证 Identity Server 返回 的 令 牌 。 其 次 ， 需 要 像 下 面 这 样 配 
置 服务 。 


Public void ConfigqureServices (lIServiceCollection services) 
{ 
/ Configure the MVC application model 
ServVvices.AddMvycCore (}); 
Services.AddAuthorization(); 
Services.AddJsonFormatters(); 
services.AddAuthentication(lIdentityServerAuthenticationDefaults. 
AuthenticationSscheme) 
.AddIdentijtyServerMAuthentication (x 三 > 


{ 
和 .Authority = "http://localhost:6000"; 
和 .AP1IName = “WeatheIT -API 
x.RequireHttpsMetadata = false; 

}); 
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注意 ， 了 最 起 码 也 需要 用 到 这 个 代码 段 中 使 用 的 MVC 应 用 程序 模型 配置 。 喘 份 
验证 方案 是 Bearer，Authority 参数 指 癌 了 使 用 的 Identity Server 的 URL。ApiName 
参数 指 回 Web API 实现 的 API 资源 ，RequireHttpsMetadata 则 决定 了 要 发 现 API 疹 
点 ， 并 不 是 必须 使 用 HTTPS。 

男 外 ， 只 需要 将 所 有 不 想 被 公开 访问 的 API 放 到 Authorize 特性 下 。 通 过 
HttpContext.User 属性 可 检 簿 用 户 信息 。 残 是 这 些 ! 当 把 访问 令 牌 提交 给 Web API 
时 ，Identity Server 的 访问 令 牌 验证 中 间 件 将 会 检查 这 个 访问 令 疲 ， 并 将 传 入 请 求 的 
受众 汇 围 与 ApiName 属性 的 值 匹配 起 来 (如 疼 10-4 所 示 )。 如 果 没 有 找到 匹配 ， 驶 返 
未 授权 错误 代 公 。 


0 references | @ 3 requests 10 exceptions 


public IActionResult Now() 


= HttpContext .User ; 

: 4 WW user {System.Security.Claims.ClaimsPrincipal} 纪 - 
| 4 pf Claims {System.Security.Claims.ClaimsPrincipal. <get Claims>d 21} 
return Co OA eS 

fié System.Collections.Generic.lEnumerator<System.Security.Claims.Claim> .Current | null 
b 后 System.Collections.IEnumeratorCurrent null 
b 4 Results View | | Expanding the Results Viel 
| | » We» @ [0] {nbf: 1507383610) 
[Authorize(Pc ®s» @ [1] {exp:1507387210} 
0 references 四 4r a [2] tiss: http://localhost:6000} 

: | 。 dA?* @ [3] {aud: http://localhost:6000/resources} 

public IActionRe ,TE 


3, string format = "json") 


{ ] b» [5] {client jd: public-account} 
var 到 LE ww [6] {scope: weather-API 
var q = new WeatherService().GetForecasts("/. 和 
。 UL I 


EE Fr 


图 10-4 Visual Studio 中 检查 HttpContext.User 对 象 的 内 容 
下 面 看 看 如 何 才能 实际 调用 API。 
8. 综合 运用 


由 于 安全 层 的 存在 ，Web API 的 调用 方 现在 必须 提供 凭据 才能 建立 连接 。 建 立 
连接 的 过 程 分 为 两 个 步 又 。 首 先 ， 调 用 方 试 图 从 配置 好 的 Identity Server 闹 皮 获取 一 
个 请 求 令 牌 。 这 样 一 来 ， 调 用 方 就 提供 了 和 凭据。 此 凭据 必须 与 Identity Server 中 注册 
的 客户 端 应 用 程序 的 凭据 匹配 。 其 次 ， 如 采 识 别 了 香 据 ， 束 发 帮 访 问 令 脾 ， 调 用 方 
必须 把 这 个 访问 令 牌 传递 给 Web API。 代 码 如 下 所 示 。 

// Obtains the actual URL to request the token from the instance of Identity Server. 


// By default, it is <server-URL>/connect/token. 
Var disco = DiscoveryClient.GetAsync ("http://localhost:6000") .Result; 


// Attempts to get an access token to call the web API. ID and secret of 
// the client application to use must be provided. 
Var tokenClient = new TokenClient (disco.TokenEndpoint, 

"Public-account", "public-account—secret™)}); 


257 


258 


第 IV 部 分 前 端 


Var tokenResponse = tokenClient.RequestClientCredentialsAsvync(" weather 
API") .Result; 
if (tokenResponse.IsError) { ... } 


上 上面 代 码 中 使 用 的 类 要 求 客 户 端 应 用 程序 项 目 中 添加 IdentityModel NuGet 包 。 
最 后 ， 在 调用 Web API 时 ， 必 须 妃 加 访问 令 牌 作为 HITP 头 。 

Var http = new HLtPCJLILIent () ; 

http.SetBearerToken (tokenResponse.AccessToken); 


Var response = http.GetAsync{("http://localhost:6001 /weather/now") .Result; 
if (!response.IsSuccessStatusCode) { ... } 


如 果 要 许可 茶 个 客户 使 用 API， 只 需要 执行 两 个 步 又。 首先 ， 提 供 在 Identity 
Server 中 为 客户 端 应 用 程序 创建 的 用 于 调用 Web API 的 凭据 ; 其次， 提供 为 API 资 
源 选 择 的 名 称 。 还 可 以 为 每 个 客户 创建 一 个 客户 痛 应 用 程序 ， 并 为 每 个 请 求 妃 加 额 
外 的 声明 ， 或 者 在 Web API 方法 中 运行 一 些 授权 代码 来 检查 实际 调用 方 的 身份 并 决 
定 如 何 处 理 。 


10.4 ”小 纺 


在 如 今 的 大 部 分 应 用 程序 中 ，Web API 是 一 个 常用 的 元 素 。Web API 用 于 问 
Angular 或 MVC 前 着 提供 数据 ， 以 及 回 移动 或 叶 面 应 用 程序 提供 服务 。 在 Web 到 
Web 的 场景 中 ， 通 过 cookie 很 容易 实现 安全 性 ， 但 是 基于 持 有 者 的 方法 不 依赖 于 
cookie， 从 而 使 得 在 任何 HITP 客户 端 都 能 够 轻松 调用 API。 

且 份 管理 服务 器 是 Web API( 也 包括 Web 应 用 程序 ) 与 其 调用 方 之 间 的 一 个 应 用 
程序 ， 提 供 了 刁 份 验证 的 能 力 ， 了 怠 像 社交 网络 能 够 做 的 那样 。 它 们 在 撒 层 使 用 的 协 
议 是 相同 的 : OpenID Connect 和 OAuth2。Identity Server 是 一 个 开源 产品 ， 可 以 在 
目 己 的 环境 中 设置 并 配置 它 ， 将 其 作为 目 己 的 身份 验证 和 授权 服务 夫 。 


ed 半 
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一 个 人 的 出 身 并 不 重要 ， 重 要 的 是 他 成 长 为 什么 样 的 人 
一 -JK. 罗 琳 ，《 险 利 。 波 特 与 火焰 杯 》 


诚然 ， 从 HTML 表单 回 Web 服务 器 提交 数据 不 需要 动脑 。HTML 会 完成 这 项 
工作 ， 你 需要 学 习 的 只 是 如 何 处 理 基 本 的 HIML 语法 。 全 于 表单 的 HIML 语法 ， 
从 早期 的 HIML 到 HTML 5 都 没有 变化 。 在 本 章 , 我 们 将 直面 现实 : 与 几 年 前 相 比 ， 
最 终 用 户 不 再 那么 乐于 接受 经 典 的 HIML 表单 。 继 续 让 浏览 器 提交 表单 ， 意 味 着 将 
刷新 整个 页 面 。 对 于 登录 表单 ， 刷 新 整个 页 面 也 许 是 可 以 接受 的 ， 但 是 如 果 表 单 的 
目的 只 是 提交 一 些 内 容 ， 而 不 需要 让 用 户 立 即 跳 转 到 不 同 的 页 面 ， 就 无 法 接受 了 。 

本 章 将 全 面 分 机 HTML 表单 ， 首 先 概述 HTML 语法， 然后 使 用 一 些 客户 端 
JavaScript 代 但 来 实际 提 区 表单 内 容 。 使 用 JavaScript 执行 提交 引发 一 些 额外 的 问题 ， 
例如 处 理 服 务 器 端 不 断 执行 的 操作 的 反 饿 ， 以 及 刷新 当前 视图 的 某 个 部 分 。 


11.1 组 织 HTML 表单 


当 按 下 HTML 表单 中 包含 的 某 个 提交 (submib 按 钮 时 ， 浏 览 器 就 会 自动 提交 
HTML 表单 的 内 容 。 浏览 器 会 自动 扫描 FORM 元 素 包 含 的 输入 字段 , 将 它们 的 内 容 
序列 化 为 字符 串 ， 然 后 对 目标 URL 设置 HTTP 命令 。 这 个 HITP 命令 的 类 型 (通常 
是 POST) 和 目标 URL 是 通过 HTML FORM 元 素 的 特性 设置 的 .目标 URL 背后 的 代 
人 码 一 一 ASPNET MVC 应 用 程序 中 的 控制 占 操 作 方 法 一 一 处 理 提交 的 内 容 ， 并 且 通 
第 会 返回 新 的 HIML 视图 。 处 理 提交 数据 时 产生 的 任何 反馈 ， 都 包含 在 返回 的 页 面 
中 。 下 面 简单 介绍 一 下 HTML 表单 的 语法 和 问题 。 
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11.1.1 定义 HTML 表单 


HTML 表 捍 是 由 一 组 INPUT 元 系 构 成 的 , 当 按 下 未 个 提交 按钮 时 , 这 些 INPUT 
元 聚 的 值 将 被 流传 输 到 一 个 远程 URL。 一 个 表单 可 以 有 一 个 或 多 个 提交 按钮 。 如 来 
没有 定义 提交 按钮 ， 那 么 除非 使 用 专门 的 脚本 代码 ， 否 则 不 能 提 区 该 表单 。 


<form method="POST™ action="@Ur]l.Action (action, controller) "> 
<input type="text" value="" /> 


i type="submit">Submit</button> 

</form> 

在 表单 中 ， 可 以 有 任意 多 的 INPUT 元 素 ， 每 个 INPTU 元 素 的 type 特性 的 值 决 
定 了 其 特征 ,type 特性 可 以 取 的 值 包括 text、 password、hidden、date 和 file 等 。 INPUT 
元 素 的 value 特性 包含 了 该 元 素 初 始 显 示 的 值 ， 以 及 按 下 提交 按钮 时 要 上 传 的 内 容 。 

除了 子 INPUT 元 素 生 成 的 内 容 以 外 ，FORM 元 素 没有 用 户 界面 。 需 要 的 所 有 
风格 ， 都 必须 通过 CSS 添加 ;而且 想 要 的 任何 布局 ， 都 必须 添加 到 FORM 元 桑 内 
部 或 者 包围 FORM 元 素 ， 因 为 这 最 合适 。 关 于 HIML 表单 ， 并 没有 什么 新 增 或 者 
新 奇 的 地 方 ， 但 是 如 果 超 出 了 基本 应 用 范围 去 使 用 ， 会 有 一 些 问 题 。 总 之 ,在 MVC 
应 用 程序 模型 中 ， 有 3 个 与 表单 有 天 的 编程 问题 。 

e 如 有 果 表 单 中 有 多 个 提 区 按钮 ， 如 何 轻松 检测 出 哪个 按钮 用 于 提交 表单 ? 

e 必须 使 用 很 多 输入 字段 时 ， 如 何 组 织 表 单 的 布局 ? 

e 提交 了 表单 并 处 理 了 表单 的 内 容 后 ， 如 何 刷 新 屏幕 ? 

接 下 来 就 深入 研究 这 些 问 题 。 


1. 多 个 提交 按钮 


有 时 候 ， 提 交 表 单 的 内 容 可 触发 服务 右上 的 一 些 不 同 的 操作 。 如 何 理 解 服务 器 
上 期 望 执 行 的 操作 呢 ? 如 果 只 使 用 一 个 提交 按钮 ， 束 必须 找到 一 种 方法 ， 在 表 时 中 
的 东 个 位 置 添加 下 够 的 信息 ， 使 MVC 控制 右 能 够 确定 期 望 执行 的 任务 。 奋 则 ， 可 
以 在 表单 中 添加 多 个 提交 按钮 。 

但 是 ， 在 这 种 情况 下 ， 无 论 单 击 了 哪个 提交 按钮 ， 目 标 URL 总 是 相同 的 ， 兵 
以 就 面临 者 同样 的 问题 : 如 何 让 服务 器 知道 应 该 执行 什么 操作 呢 ? 接 下 来 就 看 看 如 
何 把 这 样 的 信息 包含 到 BUTTON 元 素 本 号 。 

<form class="form-—horizontal"> 

<div class="form-—group"> 

<div class="col-—xs— 12"> 
<button name="option™" wvalue="add" type="submit">ADD</pbutton> 
<button name="option™" value="save™" type="submit">SAVE</button> 


<button name="option'" value="delete™" type="submit"™">DELETE</button> 
</div> 
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</div> 
</form> 


部 分 时 候 ， 不 会 为 提交 按钮 设置 name 和 value 特性 。 使 用 单个 提交 按钮 来 提交 表单 
时 ,也 可 以 忽略 这 两 个 特性 , 但 是 存在 多 个 提交 按钮 时 ， 设 置 这 两 个 值 葡 非常 关键 。 
如 何 设置 name 和 value 特性 呢 ? 在 MVC 应 用 程序 模型 中 ， 所 有 提交 的 数据 都 由 模 
型 比 定 层 处 理 。 了 解 了 这 一 点 以 后 , 可 以 让 所 有 提交 按钮 具有 相同 的 名 称 , 但 在 value 
特性 中 存储 不 同 的 值 ， 用 于 在 服务 占 上 指明 下 一 个 操作 。 

更 好 的 方法 是 , 将 value 特性 中 议 置 的 值 与 一 个 enum 类 型 的 元 素 关 联 起 来 ,如 
下 所 示 。 


public enum Options 


{ 
None = 0, 
Add = 1, 
Save = 2, 
Delete = 3 
} 


图 11-1 显示 了 在 提交 包含 多 个 提交 按钮 的 表单 时 , 使 用 这 种 HTML 代码 的 效果 。 


1 reference 

public class DemoController : Controller 
private readonly HomeService service,; 
0 references 
public DemoController(HomeService service) 


{ 
+ 


_service = service; 


0 references 
public IActionResult Multiple(string input, Options opltion) 
{ = option $ave 5 ] 
| ell } < 6,773 :lapsed 
J <6 


return View(model ); 


图 11-1 提交 按钮 的 值 映射 到 enum 类 型 的 对 应 值 
2. 大 表单 


通 第 ， 一 个 表单 中 需要 的 输入 字段 的 数量 非 营 多 。 对 于 这 种 情况 ， 可 以 使 用 一 
个 很 长 的 、 可 以 滚动 的 HIML 表单 ， 但 是 在 用 户 体验 方面 ， 很 难说 这 是 最 有 效 的 方 
案 。 首 先 ， 也 是 最 重要 的 ， 用 户 必 须 上 下 移动 才能 看 到 不 同 的 字段 ， 这 意味 看 他 们 
有 了 时候 会 转移 注意 力 ， 访 记 目 己 刚刚 输入 了 什么 。 男 外 ,错误 输入 的 值 也 是 个 问题 。 
更 严重 的 是 ， 当 数据 有 严格 的 输入 顺序 ， 先 输入 的 某 些 数据 会 影响 后 来 输入 的 某 些 
数据 时 ， 也 会 出 现 问题 。 因 此 ， 单 独 的 一 个 大 表单 不 是 个 好 方案 。 那 么 ， 如 何 把 大 
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表单 分 解 为 更 小 的 、 更 容易 管理 的 部 分 呢 ? 
可 以 在 HTML 表单 体内 引入 标签 页 .FORM 元 素 体 可 以 包含 除 子 表单 以 外 的 任 
何 HIML 元 北 。 因 此 ， 最 向 单 、 最 有 效 的 扩 巧 是 ， 使 用 标签 页 将 相关 的 竹 入 字段 分 
为 一 组 ， 使 其 他 所 有 输入 字段 隐藏 起 来 不 可 见 。 这 种 方式 对 于 用 刀 而 言 更 加 方便 ， 
因为 用 户 可 以 一 次 只 关注 一 部 分 信息 。 虽 然 分 组 得 入 控件 让 用 尸 感觉 像 是 有 多 个 表 
单 ， 但 是 在 提交 表单 内 容 方面 并 无 不 同 。 实 际 上 ，FORM 容器 是 一 个 表单 ， 因 此 ， 
要 提交 的 上 只 有 一 个 得 入 字段 的 集合 。 
<form method="post™ action="..."> 
<dliv ld="wizard"> 
< 一 一 Tabstrip 一 一 > 
<U class="nav nav-tabs" role="tablist"> 
< role~="presentation™” class="actijve"»> 
<a href="#personal™" role="tab" data-toggle="tab">You</a> 
</1i> 
<11 role="presentation"> 
<a href="#hobbies™" role="tab™" data—toggle="tab">Hobbies</a> 
</1i> 


</ul> 


<1—— Tab panes 一 一 > 

<div class="tab—content™"> 
<div role="tabpanel”" class="tab-pane active" ld="personal"> 
< 一 一 Input fields 一 一 > 
</div> 
<div role="tabpanel" class="tab--pane”" id="hobbies"> 

<1—— Input fijelds 一 一 > 

</div> 


</div> 
</div> 
</form> 


将 大 表单 分 解 为 更 小 的 部 分 ,最 徇 单 的 方法 是 使 用 Bootstrap 的 标签 页 组 件 。 将 
表单 中 的 全 部 输入 字段 分 为 儿 个 标签 页 ， 然 后 让 Bootstrap 渔 染 它们 。 用 户 将 看 到 一 
个 经 典 的 tabstrip， 其 中 的 每 个 窗 格 包含 怕 输 入 表单 的 一 小 万。 这 样 ， 用 户 可 以 一 次 
只 关注 一 小 块 信息 ， 几 乎 不 需要 上 下 滚动 浏览 项 窗口 。 

提交 按钮 的 列表 可 放 到 你 认为 最 合适 的 地 方 。 例 如 ， 可 以 把 它们 与 标签 页 放 在 
同一 行 ， 可 能 靠近 视 区 的 在 边缘。 下 面 的 Bootstrap 标记 用 于 tabstrip 内 的 一 个 表单 
提交 按钮 。 

<ul> 

<1i> ... </li> 

<1i> ... </l1i> 

<11> ... </1i> 


<button class="btn btn-danger pull-right">SAVE</button> 
</ul> 
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图 11-2 显示 了 一 个 大 的 、 用 标签 页 分 隅 的 表单 。 


THIS IS A LARGE FORM 


General Emall Password 


Contact tact na 


ed Can't be empty! 


Address 


11-2 ”由 标签 页 分 隔 的 输入 表单 


;于 局 
可 以 自由 访问 所 有 标签 页 ， 就 如 同 这 个 表单 只 是 一 个 长 长 的 输入 字段 列表 。 如 
果 想 实施 规则 ， 让 表单 的 体验 接近 向 导 ， 建 议 在 创建 自己 的 基础 结构 之 前 ， 先 研究 
一 些 jQuery 插件 。 可 以 从 Twitter Bootstrap Wizard 插件 入 手 。 


如 前 所 述 ， 数 据 是 照 弟 提交 有 的， 并且 照常 补 MVC 模型 绑 定 层 捕获 。 客 户 闹 验 
证 也 是 照 钊 上 友 生 的 。 但 是 ， 在 这 种 情况 下 ， 有 另外 一 个 问题 : 当 和 输入 字段 存在 错误 
时 ， 如 何 回 用 户 反 馈 ? 假设 用 户 进 入 Password 标签 页 ， 输 入 了 一 些 无 效 的 数据 。 接 
下 来 ， 她 进入 Email 标签 页 ， 输 入 一 些 可 接受 的 数据 ， 然 后 单 击 SAVE 按钮 。 在 当 
前 可 见 的 标签 页 验证 失败 ， 所 以 用 户 无 法 立即 看 到 所 泻 染 的 任何 界面 上 的 反馈 。 在 
这 种 情况 下 ， 建 议 找到 一 种 方法 来 拦截 验证 铬 误 ， 在 发 生 错 误 的 标签 页 上 添加 一 个 
图 标 ， 使 用 己 知 道 在 什么 地 方 输入 了 无 效 数据 (和 后 将 继续 讨论 这 一 问题 )。 


11.1.2 ” Post-Redirect-Get 模式 
在 服务 器 新 的 Web 开发 中 ， 有 一 些 由 来 已 久 的 问题 ， 人 至今 还 人 


肖 接 受 的 权威 解决 万 条 。 其 中 一 个 问题 就 是 如 何 处 理 POST 请 求 的 响应 ， 不 管 
啊 应 是 普通 的 HIML 视图 、JSON 包 还 是 钙 误 。 处 理 POST 啊 应 的 问题 对 客户 
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用 程序 基本 没什么 影响 , 在 这 样 的 应 用 程序 中 ,POST 请 求 是 通过 JavaScript 从 客户 
痛 友 出 和 管理 的 。 为 此 ， 许 多 开 有 友人 员 称 之 为 “ 假 问 题 ” 只 有 老 派 的 开 有 友人 员 才 可 
能 过 到 。 但 是 ， 如 果 读 到 了 了 这里， 并且 MVC 是 你 首选 的 应 用 程序 模型 ， 那 么 很 有 
可 能 你 的 解决 方案 并 不 是 完全 由 客 尸 问 交 互 构成 。 这 童 味 看 讨论 Post-Redirect-Get 
模式 一 一 处 理 表 蛙 提交 时 建议 使 用 的 模式 一 一 是 有 意义 的 。 


注意 : 

”从 CQRS 的 角度 看 ，Post-Redirect-Get 模式 也 很 有 启发 意义 。CQRS(Command-Query 
Responsibility Segregation, 命令 -查询 职 贡 分 离 ) 是 一 种 新 出 现 的 模式 ,， 用 于 使 应 用 程 
序 的 查询 堆栈 和 命令 堆栈 分 隔 开 ， 从 而 独立 地 开发 、 部 署 和 扩展 它们 。 在 Web 应 用 
程序 中 ， 表 单 提交 由 命令 堆栈 处 理 ， 向 用 户 显示 一 些 可 视 化 的 响应 则 由 查询 堆栈 负 
责 。 因 此 ， 当 完成 了 全 部 任务 ， 并 且 用 户 界 面 以 其 他 方式 更 新 后 ， 提 交 请 求 才 会 结 
束 。 此 外 ，Post-Redirect-Get 模式 提供 了 一 种 刷新 用 户 界 面 的 方式 ， 实 现 了 命令 -查询 
堆栈 的 分 隔 。 


1. 使 问题 正式 化 


假设 用 户 在 一 个 Web 页 和 面 内 提交 了 一 个 表单 。 从 浏览 占 的 角度 看 ， 这 是 一 个 普 
通 的 HITP POST 请 求 。 在 服务 器 端 ， 该 请 求 被 映射 到 一 个 控制 器 方法 ， 该 方法 通 
常 壮 染 回 Razor 模板 。 结 果 ， 用 户 收 到 一 些 HTML 并 感到 满意 。 一 切 都 很 正常 ， 哪 
里 有 问题 呢 ? 

问题 有 两 个 ,一 是 显示 的 URIL( 反 上 映 了 表单 操作 , 因而 可 能 显示 “save ”或 “edit”) 
与 用 户 看 到 的 视图 (是 一 个 get 操作 ) 不 一 致 。 另 一 个 问题 与 浏览 器 跟踪 的 最 后 一 个 操 
人 有 > 

所 有 的 浏览 器 都 会 跟踪 用 户 最 后 请 求 的 HTTP 命令 , 当 用 户 按 下 F5 键 或 者 “ 刷 
新 ”菜单 项 时 ， 就 会 重新 执行 该 命令 。 在 这 种 情况 下 ， 最 后 的 请 求 是 HTTP POST 
请 求 。 重复 提交 可 能 很 危险 ， 因为 POST 操作 通常 会 改变 系统 的 状态 。 为 安全 起 见 ， 
操作 应 当 是 一 个 车 等 操作 ( 即 重 复 执 行 时 ， 不 会 修改 状态 )。 为 了 警告 用 户 在 提交 后 
刷新 可 能 存在 风险 ， 所 有 的 浏览 堪 都 会 显示 一 条 如 图 11-3 所 示 的 消 忆 。 


Resubmit form? 


To refresh this page, your browser needs to repeat any actions 
you've already taken. For example, if you've already entered 
info into a form, your info will be resubmitted to the site. 


Retry Cancel 


图 11-3 重复 执行 POST 请 求 时 ，Microsoft Edge 浏览 器 显示 的 警告 消息 
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这 种 警告 对 话 框 已 经 存在 了 很 多 年 ， 并 没有 阻止 Web 的 传播 ， 但 是 很 难看 。 不 
过 ， 消 除 这 些 对 话 框 并 不 像 看 起 来 那样 简单 。 为 了 避免 看 到 这 种 消息 ， 应 该 重新 考 
虑 服务 器 疹 Web 操作 的 整个 流程 ， 但 这 又 产生 了 新 问题 。 


2. 解决 问题 


Post-Redirect-Get (PRG) 模 式 包 含 一 些 建 议 ， 上 自在 傈 证 每 个 POST 命令 实际 上 以 
GET 命令 结束 。 它 解决 了 FS 刷新 问题 ， 并 使 HITP 的 命令 操作 和 但 询 操 作 之 间 的 
分 隔 更 整洁。 

问题 的 根源 在 于 ， 在 典型 的 Web 交互 中 ,， 洽 染 用 户 界 面 的 POST 命令 会 后 跟 一 
个 隐 式 的 GET。PRG 模 ie 问 或 者 另外 一 个 与 重 定向 效果 相同 的 客户 疹 
请 求 ， 使 这 个 GET 命令 成 为 显 式 命令 。 下 面 给 出 了 一 些 具体 的 代码 。 

[HttpGet] 
[ActionName ("reglister")l| 


public ActionResult ViewReglister () 

{ 
// Display the View through which the user will register 
return View(); 


} 


要 进行 注册 ， 用 户 需 要 填写 并 提交 表单 。 这 会 产生 一 个 新 的 请 求 ， 以 POST 命 
令 的 形式 提交 ， 并 用 下 面 的 代码 处 理 。 
[HttpPostl] 


[ActionName ("reglister")l]| 
public ActionResult PostRegister (RegisterIinputModel jinput) 


{ 
// Alters the state of the system (i.e., register the user) 
// Queries the new state of the system for UI purposes. 
// (This step is an implicit GET) 
return View () 
} 


如 上 面 的 代码 所 示 ，PostResgister 方法 会 修改 系统 的 状态 ， 并 通过 一 个 内 部 的 服 
务 器 问答 询 返 回 修改 后 的 状态 。 对 于 浏览 器 而 言 ， 这 只 是 一 个 POST 操作 ， 返 回 一 
些 HTML 响应 。 要 对 这 段 代 码 应 用 PRG 模式 ， 只 需要 做 一 点 修改 : 在 POST 方法 
中 ， 不 返回 视图 ， 而 是 将 用 己 重 定 同 到 男 一 个 页 和 面 。 例 如 ， 可 以 重 定 问 到 相同 操作 
的 GET 方法。 

[HttpPost]| 

[ActionName ("register")l] 


public ActionResult PostReglister (RegisterInputModel jinput) 


{ 
// Alters the state of the system (i.e., register the user) 
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// Queries the new state of the system for UI purposes. 
// (This step is NOW an explicit GET via the browser) 
return RedirectToAction(" regilister"™) 
} 
因此 ， 最 后 跟踪 到 的 操作 是 GET， 这 就 解决 了 5 刷新 问题 。 不 止 如 此 ， 浏 览 
右 地 址 柱 中 显示 的 URL 现在 更 有 意义 。 
如 果 要 创建 经 典 的 服务 占 应 用 程序 ， 在 处 理 每 个 请 求 后 刷新 整个 负面， 束 应 访 
采用 PRG 模式。 有 一 种 更 加 现代 的 方法 没有 POST/GET 被 合并 到 一 起 的 问题 ， 奔 
是 通过 JavaScript 提交 表单 的 内 容 。 


11.2 ”通过 JavaScript 提交 表单 


如 采 提 交 是 浏览 器 发 起 的 操作 ， 那 么 目标 URL 返回 的 输出 不 经 季 选 束 会 显示 
给 用 户 。 如 果 通 过 JavaScript 提交 ， 则 客 尸 疾 代 人 码 束 很 有 可 能 控制 并 省 理 整 个 提交 
操作 ， 使 用 户 体 验 非常 流畅 。 

个 官 使 用 什么 框架 (可 能 是 普通 的 jQuery， 也 可 能 十 更 加 复杂 的 框 染 )， 提 区 
HTML 表单 的 步骤 都 可 以 总 结 如 下 : 

e 从 表单 的 输入 字段 中 收集 要 提交 的 数据 。 

e 将 各 个 字段 值 序列 化 为 数据 流 ， 以 便 能 够 打包 到 一 个 HITP 请 求 中 。 

e 准备 并 运行 Ajax 调用 。 

e 接收 响应 ， 检 查 错 误 ， 并 相应 地 调整 用 户 界面 。 

但 是 ， 不 需要 手动 执行 上 面 的 所 有 步骤 。 所 有 的 浏览 器 都 提供 一 个 API 来 编写 
FORM 元 素 的 脚本 ， 就 像 在 本 地 DOM 中 的 编码 一 样 。 因 此 ， 我 们 要 做 的 就 是 编写 
JavaScript 代码 ， 让 浏览 右 市 外 提交 表单 ， 并 相应 处 理 啊 应 。 


11.2.1 上 传 表单 内 容 


HTML 标准 文件 中 定义 了 包含 表单 内 容 的 HITP 请 求 的 请 求 体 应 该 是 什么 样子 
的 。 这 个 请 求 体 是 字符 串 ， 由 输入 的 名 称 和 相关 的 值 连接 起 来 构成 。 每 个 名 称 / 值 对 
通过 & 符 号 连接 到 下 一 个 名 称 / 值 对 。 


namel=~=valuelé&name?~value?t&tname3=value3 


有 很 多 方式 可 以 创建 这 种 字符 串 。 可 以 读 取 DOM 元 素 的 值 ， 自 己 创建 这 个 字 
符 串 ， 但 是 使 用 jQuery 工具 更 快 ， 也 更 可 徘 。 
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1. 序列 化 表单 


特定 情况 下 ，jQuery 库 提供 的 serialize 函数 接受 FORM 元 素 作 为 参数 ， 通 过 
INPUT 子 元 素来 循环 ， 并 返回 最 终 的 字符 串 。 


Var form = $("#your-form-element—-id™); 
Var body = 


jQuery 中 的 另 一 个 选项 是 $.param 图 数 。 这 个 函数 的 输出 与 serialize 函数 相同 ， 
但 是 它 接受 的 输入 类 型 与 serialize 函数 不 同 。serialize 只 能 在 表单 上 调用 ， 它 会 目 动 
扫 摘 和 输入 字段 的 列表 ; $.param 则 要 求 提 供 显 式 的 名 称 / 值 对 ， 不 过 产生 的 输出 是 相 
同 的 。 

有 了 要 序列 化 的 内 容 后 ， 只 需要 发 出 HTTP 请 求 。 注 意 ， 浏 览 器 还 在 DOM 的 
FORM 元 素 上 提供 了 submit 方法 。 其 效果 与 发 出 HTTP 调用 不 同 。submit 方法 产生 
的 效果 与 按 下 提 区 按钮 相同 ， 即 浏览 右上 传 表单 内 容 ， 然 后 刷新 整个 页 和 面 。 如 果 管 
理 日 己 的 HTTP 调用 ， 能 够 完全 控制 工作 流 。 


2. 发 出 HTTP 请 求 


form.serializel().; 


要 发 出 HTTP 请 求 ， 需 要 再 次 使 用 jQuery。 使 用 HTML form 元 素 的 method 特 
性 指定 的 HITP 动词 上 传 表单 。 目标 URL 则 是 由 其 action 特性 的 内 容 指 明 的 。 下 面 
给 出 了 AJAX 调用 示例 ， 可 用 于 上 传 HTML 表单 的 内 容 。 


Var form = $("#your-form-element-—-iqd"™");} 
$5-.ajaxt(l 

cache: false, 

url: form.attr("action™), 

type: form.attr("method"™), 

dataType: "html™, 

data: form.serialize(), 

SUCCeSS: sucCcess, 

error: error 


hs 


jQuery 的 ajax 函数 允许 传 入 两 个 回调 来 处 理 请 求 的 成 功 或 者 失败 。 需 要 注意 的 
是 ， 成 功 或 者 失败 是 指 啊 应 的 状态 公 ， 而 不 是 物理 HITP 请 求 背 后 的 业务 操作 。 换 
句 话 说 , 如 果 请 求 触发 的 命令 失败 , 但 是 服务 器 代码 能 够 处 理 这 个 异常 , 并 在 HTTP 
200 啊 应 中 返回 一 条 错误 消息 ， 则 不 会 触发 错误 回调 。 下 和 耐看 看 通过 Ajax 和 
JavaScript 调用 ASPNET MVC 端点 的 情况 。 
public IActionResult Login(LogininputModel credentials) 
{ 
// Validate credentials 
var response = TryAuthenticate (credentials);} 


if (I!response.Success) 
throw new LogjnFalledException (espPponse .Message) : 
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Var returnUrl = ...} 
return Content (returnUrl); 


} 


在 这 里 ， 如 果 映 份 验 证 失败 ， 束 会 抛 出 异常 ， 总 味 看 请 求 的 状态 人 码 变 为 HITP 
5$00， 将 调用 铅 误 处 理 程序 。 和 否则 ， 返 回 下 一 个 URL， 即 希望 在 用 尸 成功 登录 后 将 
其 重 定向 到 的 URL。 注意, 因为 这 个 方法 是 通过 Ajax 调用 的 , 重 定 问 到 男 一 个 URL 
的 操作 只 能 通过 JavaScript 在 客户 闹 完 成 。 


Window.location.href = 三” --- 
表单 的 提交 是 在 表单 按钮 的 click 处 理 程序 中 调用 的 。 为 了 防止 单 击 按钮 时 浏览 
骼 目 动 提交 表单 ， 可 能 需要 将 按钮 的 type 特性 从 submit 改 为 button 。 


<button type="button™" id="myForm">SUBMIT</button> 


在 提交 表单 之 前 和 之 后 ，click 处 理 程 序 可 以 执行 额外 的 任务 ， 包 括 向 用 户 提供 
一 些 反馈 . 


3. 同 用 尸 提 供 反 馈 


无 论 请 求 成 功 还 是 失败 ， 回 调处 理 程序 都 会 收 到 控制 右 方 法 返回 的 所 有 数据 ， 
并 负责 显示 这 些 数 据 。 要 显示 这 些 数据 , 可 能 需要 解 包 数据 , 并 把 数据 分 割 到 HIML 
用 户 界 面 的 各 个 部 分 。 如 有 果 表 单 提交 成 功 ， 可 能 需要 回 用 户 显 示 一 条 确认 消息 ， 例 
如 “操作 成 功 完成 !”"。 更 重要 的 是 ， 如 采 表 单 提交 失败 ， 可 能 需要 提供 一 些 细节， 
指出 某 些 输入 数据 不 正确 。 你 自己 决定 是 便 编 码 消息 (成 功 或 失败 )， 还 是 在 服务 器 
站 根据 不 同 的 上 下 文 显 示 不 同 的 消 县 。 如 采 在 服务 亏 冰 生成 消息 ， 则 可 能 需要 定义 
要 返回 的 可 序列 化 的 数据 结构 ， 该 数据 结构 包含 操作 的 结果 ， 并 描述 操作 过 程 中 发 
生 了 什么 。 我 喜欢 使 用 下 面 的 结构 : 

public class CommandResponse 

public bool Success { get; set; } 


Public string Message 1{ get; set; } 
} 


消息 应 该 一 直 在 屏幕 上 显示 ， 直 到 执行 下 一 个 操作 吗 ? 让 错误 消息 一 直 显示 在 
屏幕 上 ， 直 到 下 一 次 提交 ， 可 能 是 合理 的 ,但 是 在 某 个 时 间 点 ， 必 须 删 除 错误 消息 。 
可 以 在 刚好 要 再 次 提交 表单 之 前 删除 错误 消息 。 对 于 成 功 消息 ， 情 况 有 所 不 同 。 显 
示 成 功 确认 消息 很 重要 ， 但 是 这 条 消息 不 能 打扰 到 用 户 ， 也 不 应 该 显示 太 长 时 间 。 
对 于 成 功 消息 ， 我 会 避免 使 用 模式 弹出 对 话 框 ， 而 是 将 消息 绑 定 到 一 个 定时 器 ， 让 
它 一 开始 显示 为 一 条 文本 ， 穿 插 在 常规 的 用 户 界面 中 ， 然 后 在 儿 秒 钟 之 后 ， 无 须 用 
户 干预 就 自动 消失 。 

折 中 的 方法 是 在 DIV 中 显示 消息 ， 这 个 DIV 看 起 来 像 警告 框 ， 给 用 户 提供 了 
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单 击 按钮 关闭 消息 的 机 会 。 采 用 这 种 方法 时 ， 通 第 使 用 Bootstrap 的 alert 类 来 设置 
消 明 容器 的 样式 ， 并 在 全 局 布局 中 使 用 下 向 的 JavaScript 代码， 使 其 日 动 应 用 到 所 
有 警告 枉 ， 这 样 关闭 它们 会 更 傈 单 。 

$s(".alert™.) -clLicKI(Etunction(eh) 1 

$s (this) .hide(); 

}); 

注意 ，Bootstrap 本 刁 也 文 持 可 关 团 的 警告 枉 ， 但 是 我 友 现 ， 用 上 面 的 技巧 编写 
起 来 更 快 ,对 于 用 户 而 言 也 更 简单 ,因为 用 户 可 以 单 击 或 触摸 任 意 位 置 来 天 闭 消 且 。 
图 11-4 显示 了 在 通过 JavaScript 提交 表单 时 出 现 的 错误 消息 。 


过 起 httpylocalhost 50543/demolarge -© | Search.. 


THIS IS A LARGE FORM 


General Email A Password 


Contact D 


gp Gant be empty! 


Address D 


图 11-4 “客户 端 管理 的 HTML 表单 中 的 错误 消息 


给 用 尸 的 反馈 是 帮 在 客 尸 问 外 面 的 。 下 向 给 出 了 一 些 示 例 代 人 友 。 要 想 了 解 更 多 
细节 ， 特 别 是 用 于 支持 所 描述 行为 的 JavaScript 库 的 细节 ， 参 考 本 书 附带 的 示例 代 
但 ( 参 见 http://github.conydespos/progcore)。 具 体 来 说 ， 可 但 看 Chll 文件 夹 中 的 
ybq-core.js 文件 。 

Ybq.postForm{"#large-form", 

function(data) 二 
Var response = JSON.parse (data);} 
Ybq.toast ("#1large-form-message", 


TESpPONSeS .MSSAaUder 
IESpPONSe. success) 和 
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postForm 函数 只 是 一 个 包装 器 ， 包 含 前 面 给 出 的 Ajax 代码 段 : 


Var form = ${("#your-form-element—-id"™); 
5.ajax(t{ 

cache: false, 

url: form.attr ("action"™), 

type: form.attr("method"™), 

dataType: "html™, 

data: form.serialize(), 

SUCCeSS: SUCCeSS， 

error: error 


}); 
toastr 方法 是 一 个 辅助 程序 例 程 ， 在 DIV 中 显示 消息 ， 并 在 几 秒 后 使 其 目 动 超 
时 。DIV 的 样 卫 与 操作 的 结 来 (成 功 或 失败 ) 一 致 (如 岁 11-5 所 示 )。 


OO 入 http//ocalhost:; 


盖 localhost 


THIS IS A LARGE FORM 


Operation completed successfully 


General Email Password 
Email #1 dg 二 d.com 
?237 


Ermail #2 


Email #3 


图 11-5 客户 端 管理 的 HIML 表单 中 的 错误 消 


) 王 忌 : 

在 ASPNET Core 中 ， 序 列 化 对 象 并 返回 给 客户 端的 Json 方法 足够 智能 ， 能 绷 
根据 JavaScript 的 大 小 写 约 定 进 行 友 列 化 ,为 此 , 当 厅 列 化 前 面 的 CommandResponse 
类 型 时 ，C# 属 性 (如 Success 和 Message) 变 成 了 JavaScript 属性 (Success 和 message)。 
这 与 MVC 5.x 不 同 。 


11.2.2 刷新 当 表 屏 医 的 一 部 分 


提交 表单 且 操 作成 功 完 成 后 ， 有 时 需要 刷新 当前 用 户 界 面 的 几 个 部 分 。 如 采 表 
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单 是 通过 浏览 堪 提 区 的 , 那么 PRG 模式 确保 使 用 最 新 的 信息 完全 草 绘 新 的 负面。 但 
使 用 JavaScript 从 客户 闯 捉 交 表 单 内 容 时 ， 和 是 另外 一 种 情况 。 


1. 更 新 用 户 界 面 的 一 小 部 分 


有 时 候 ， 当 前 用 户 界面 中 需要 更 新 的 部 分 很 少 ， 而 且 更 重要 的 是 ， 从 表单 的 内 
容 可 以 确定 新 的 内 容 是 什么 。 在 这 种 情况 下 ， 要 做 的 就 是 将 小 段 新 内 容 保存 到 一 些 
局 部 变量 中 ， 使 用 它们 来 更 新 相关 的 DOM 元 素 。 在 这 种 上 下 文中 ， 用 户 界面 的 一 
小 部 分 可 以 非常 简单 、 简 洁 ， 如 字符 串 或 者 数字 。 
Ybq.postForm("#1large-form", 
function(data) I 


// Deserialize the received response 
Var response = JSON.parse (data); 


// Update the UI 

if (response.success) 1 
Var name = $("#contactname") .val (): 
$ ("#public-name") .html (name). 

} 


// Give feedback about the overall operation 

Ybq.toast ("#1large-form-message"™, 
response.message, 
response.success);} 


hs 


在 这 个 示例 中 ,假定 视图 包含 一 个 文本 标签 public-name， 将 其 设置 为 表单 中 联 
系 人 的 名 称 。 


2. 回调 服务 器 来 获取 分 部 视图 


有 时 ， 刷 新 用 户 界 面 可 能 没 那么 简单 。 刷 新 标签 的 文本 并 不 复杂 ， 但 有 时 需 
要 使 用 一 整 段 HIML。 这 段 HTML 可 以 放 到 客户 端 ， 但 是 除非 使 用 了 某 个 客户 
站 数据 绑 定 库 ( 本 章 稍 后 详细 介绍 ), 否则 只 是 引入 了 淤 在 的 双重 故障 点 。 基 本 上 ， 
服务 礁 病 的 代码 和 客户 端的 代码 在 不 同时 间 生 成 了 相同 的 HTML 输出 。 这 总 味 
看 要 修改 实际 的 样式 或 布局 ， 必 须 使 用 两 种 不 同 的 语言 应 用 到 两 个 不 同 的 地 方 。 

在 这 些 情况 中 ,更 可 徘 的 方法 是 回调 服务 器 ,让 服务 紫 提 供需 要 的 HTML 代码 
段 。 这 有 助 于 使 用 户 界 面 组 件 化 。 第 5 革 讨 论 了 视图 组 件 。 我 的 看 法 是 , 如 果 HIML 
代码 段 足够 复杂 ， 就 可 以 将 其 实现 为 视图 组 件 ， 并 命令 它 刷 新 。 有 时 候 ， 可 以 使 其 
成 为 分 部 视图 ， 只 是 同 攻 个 控制 絮 深 加 一 个 新 的 操作 方法 ， 使 其 返回 系统 当前 状态 
修改 过 的 分 部 视图 。 下 面 给 出 了 一 个 例子 。 

[HttpGet] 


public IActionResult GetLoginView () 
{ 
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// Get any necessary data 
Var model = service.GetAnyNecessaryData (); 
return new PartialView("pv loginbox", model); 


} 

这 个 方法 是 通过 Ajax 调用 的 , 返回 了 某 个 用 户 界 和 面部 分 的 当前 状态 。 它 把 填充 
HTML 所 需要 的 数据 收集 起 来 ， 传 递 给 Razor 视图 引擎 来 填充 分 部 视图 。 客 户 端 应 
用 程序 收 到 一 个 HTML 字符 串 ， 使 用 jQuery 的 html 方法 来 更 新 HTML 元 素 ( 最 第 
见 的 是 DIV)。 


11.2.3 将 文件 上 传 到 Web 服务 器 


在 HIML 中 , 文件 的 处 理 方式 基本 上 与 其 他 类 型 的 输入 一 样 ， 尽管 文件 与 基本 
数据 之 间 区 别 非常 大 。 与 之 前 一 样 ， 首 先 创建 一 个 或 多 个 INPUT 元 素 ， 将 其 type 
特性 设 为 file。 原 生 的 浏览 器 用 户 界面 允许 用 户 选 择 一 个 本 地 文件 ， 然 后 简化 该 文 
件 的 内 容 与 表单 的 其 余 内 容 。 在 服务 器 端 ， 将 文件 内 容 映 射 到 新 类 型 IFormFile， 并 
日 与 以 前 版 本 的 MVC 相 比 ， 横 型 绑 定 层 处 理 文件 内 容 的 方式 更 加 统一 。 


1. 设置 表单 
要 选择 一 个 本 地 文件 上 传 ， 严 格 来 说 使 用 下 面 的 标记 吏 足 够 了 。 
<input type="file™” id="picture” name="plicture"> 


虽然 出 于 用 户 界 面 的 原因 ， 必须 把 上 面 的 代码 放 到 HTML 页 面 中 , 但 是 通常 把 
它 隐 着 起 来 。 这 就 允许 应 用 程序 提供 更 好 看 的 用 尸 界面 ， 同 时 仍然 能 够 打开 本 地 资 
源 管理 需 窗口 。 

常见 的 技巧 是 隐藏 INPUT 元 素 (如 图 11-6 所 示 ), 显示 一 个 好 看 的 用 户 界面 让 用 
己 单 击 。 然 后 ， 单 击 处 理 程序 会 将 单 击 事件 半 发 给 隐藏 的 INPUT 元 素 。 


<input type="file™” id="picture” name="plicture"> 
<diyv onclick="$ ('#picture') .click()">image not available</div> 


要 正确 上 传 表单 内 容 , 还 必须 使 用 固定 值 multipart/form-data 指定 enctype 特性 。 
2. 在 服务 器 上 处 理 文件 内 容 


在 ASPNET Core 中 ， 将 文件 内 容 抽 象 为 下 ormFile 类 型 ， 访 类 型 基本 上 保留 了 
MVC 5 应 用 程序 中 使 用 的 HttpPostedFileBase 类 型 的 编程 接口 。 


public IActionResult UploadForm(FormIinputModel input, IFormFile picture) 
{ 

if (picture.Length > 0) 

{ 


var fileName = Path.GetFileName (picture.FileName); 
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Var filePath = Path.Ccombine( env.ContentRootPath, “Uploads", fileName); 
USinNnGg (var stream = new FileSstream(lfilePath, FileMode.Create)) 


{ 


picture.CopyTo (stream); 


是 “一 


FORM NAME 


userQ@server.com 
Dino 

Not specified 
ltaly 


Image not 
avallable 


SUBMIT 


图 11-6 隐 闫 的 INPUT 文件 元 系 


注意 ， 也 可 以 把 IFormFile 引用 试 加 到 FormInputModel 复杂 类 型 中 ， 因 为 模型 
纤 定 和 E 人 够 轻松 地 按照 名 称 映 射 内 容 ， 就 像 处 理 基 本 和 复杂 的 数据 类 型 那样 。 上 面 的 
代码 根据 当前 内 容 根 文 件 夹 设置 文件 名 ， 然 后 使 用 上 传 文件 的 原名 称 创建 了 该 文 件 
在 服务 占 病 的 副本 。 如 有 果 上 传 了 多 个 文件 ， 只 需要 引用 一 个 正 ormFile 类 型 的 数组 。 


如 果 通 过 JavaScript 提 区 表单 ， 那 么 最 好 用 下 面 的 代码 替换 前 面 看 到 的 表单 序 
列 化 代 但 : 


Var form = ${("#your-form-element—-id"™); 
Var formData = new FormData (form[0|); 
form.find("input[type=filel"} .each (function () { 
formData.append($ (this) .attr("name"), $ (this) [0] .files[0]); 
}); 
-ajaxt(l 
cache: false, 
url: form.attr("action™), 
type: form.attr("method™), 
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dataType: "html", 
data: formData, 
SUCCeSS: SUCCess, 
error: error 


}); 
这 段 代 但 确保 所 有 的 输入 文件 都 会 被 序列 化 。 
3. 文件 上 传 的 问题 


上 和 面 的 代码 肯 定 可 以 处 理 小 文件 ， 尽管 很 难 定 义 “ 小 ”意味 看 什么 。 可 以 说 ， 
一 般 情 况 下 都 可 以 使 用 这 段 代 码 ， 除 非 事先 知道 要 上 传 的 文件 有 30MB 。 在 这 种 
情况 以 及 在 文件 大 小 导致 Web 服务 出 现 延 迟 的 情况 下 ， 可 以 考虑 流 式 处 理 文件 
的 内 容 。 许 细 的 说 明 请 参见 http://docs.microsoft.com/en-us/aspnet/core/mvc/models/file 
-Uploads 

如 今 ， 这 只 是 上 传 文件 可 能 遇 到 的 第 一 个 问题 。 另 一 个 问题 是 ， 需 要 有 动态 性 
和 区 互 性 非 钊 好 的 用 户 界 面 。 用 户 可 能 期 望 看 到 可 视 化 的 反馈 来 了 解 上 传 操作 的 
进度 。 而 且 ， 当 要 上 传 的 文件 是 图 片 ( 如 已 注册 用 户 的 照片 ) 时 ,用户 甚 全 可 能 布 望 
看 到 一 个 预 宽 ， 并 且 能 够 取消 之 前 选择 的 图 片 ， 让 该 字段 留 空 。 所 有 这 些 操作 都 
可 以 实现 , 但 需要 做 一 些 工 作 。 可 以 考虑 使 用 某 个 专门 的 组 件 ， 如 Dropzone.js( 参 见 
http://dropzone]s.com). 

男 外 一 个 问题 与 如 何在 服务 占 病 保存 上 传 文件 的 副本 有 关 。 上 和 面 显 示 的 代 公 在 
服务 器 上 创建 了 一 个 新 文件 。 需 要 注意 ， 如 果 引 用 的 文件 夹 不 存在 ， 上 面 的 代码 将 
抛 出 民利 。 多 年 来 ， 这 种 方法 一 直人 够 用 ， 但 是 随 独 云 模 型 越 来 越 重要 ， 这 种 方法 的 
吸引 力 在 下 降 。 如 有 条 把 上 传 的 文件 本 地 存储 到 Web 应 用 程序 ， 而 该 Web 应 用 程序 
在 Azure App Service 中 托管 ， 那 么 这 个 应 用 程序 的 工作 将 是 透明 的 ， 因 为 同一 个 
App Service 的 多 个 实例 会 共 至 相同 的 存储 空间 。 通 党 ， 最 好 不 要 把 上 传 文件 保存 在 
主 服 务 器 。 除 非 云 平台 爆炸 式 增 长 ， 否 则 除了 在 本 地 存储 文件 或 数据 库 ， 和 
选择 。 云 提供 了 便宜 的 Blob 存储 ， 可 用 于 存储 文件 ， 即 使 文件 大 小 超出 了 经 典 A 
Service 配置 的 存储 限制 。 

可 以 重 写 上 币 的 代码 ， 将 上 传 的 图 片 保 存在 Azure Blob 容器 。 为 此 ， 需 要 有 
Azure 存储 账户 。 

// Get the connection string from the Azure portal 


Var storageAccount = CloudstorageAccount.Parsel("connection string to your 
storage account™);} 


// Create a container and save the blob to it 

Var blobClient = storageAccount.CreateCloudBlobClient (); 

Var container = blobClijent.GetContainerReference ("my—container™)});}; 
container.createIfNotExistsAsync (); 

Var blockBlob = container.GetBlockBlobReference ("my-blob-name™); 
USInG (var stream = new MemorySsStream()) 
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{ 
picture.CopyTo (Stream) : 
blockBlob.UploadFromSstreamAsync (stream); 
} 
Azure Blob 存储 是 用 容器 表示 的 ， 每 个 容器 与 一 个 账户 绑 定 。 在 容器 内 ， 可 以 
有 任意 多 的 Blob。Blob 由 一 个 二 进 制 流 和 一 个 唯一 名 称 标识 。 要 访问 Azure Blob 
存储 , 还 可 以 使 用 REST API, 所 以 在 Web 应 用 程序 外 部 也 是 可 以 访问 Blob 存储 的 。 


注意 : 
要 测试 Azure Blob 存储 ， 可 以 使 用 Azure Blob 模拟 器 ， 它 允许 在 本 地 试用 该 平 
台 的 API. 


11.3 ”小结 


目前 ， 当 用 户 执行 任何 操作 时 ， 应 用 程序 几乎 无 法 负担 整个 页 面 的 刷新 。 虽 然 
仍然 有 不 少 网 站 是 基于 老 方法 构建 的 ,但 是 不 能 将 其 作为 借口 而 不 构建 更 好 的 网 站 。 
除了 ASPNET Core， 还 可 以 创建 Angular 应 用 程序 ， 通 过 调用 远程 服务 并 本 地 刷新 
用 户 界 面 ， 来 执行 数据 访问 任务 。 不 管 是 通过 Angular( 或 类 似 框架 )， 还 是 在 Razor 
视图 中 使 用 普通 的 JavaScript， 都 应 该 努力 使 用 户 界 面 更 加 顺畅 、 平 滑 。 

本 章 介 绍 如 何 使 用 JavaScript 代码 ， 从 客户 端 向 服务 器 提交 数据 。 第 12 章 将 介 
绍 从 远程 服务 器 获取 了 客户 端 页 面 的 内 容 以 后 ， 有 哪些 选项 可 以 把 这 些 内 容 泻 染 为 
HIML., 
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客户 中 数据 绑 定 


我 们 最 大 的 错误 就 在 于 企图 从 他 人 那里 获得 他 并 不 具备 的 美德 ， 而 忽视 培养 他 


一 一 玛 格 丽 特 * 尤 全 纳 尔 , 《 哈 德 民 回忆 录 》 


术语 “数据 绑 定 ”是 指 通过 编程 方式 ， 用 新 数据 更 新 可 视 组 件 的 能 力 。 一 个 规 
范 示 例 是 ， 为 文本 框 赋 值 一 条 默认 显示 的 文本 ， 供 用 户 编辑 。 因 此 ， 数 据 绑 定 正 如 
其 名 称 所 示 ， 是 一 种 在 软件 中 将 数据 与 可 视 组 件 绑 定 起 来 的 方式 。HTML 元 素 (不 只 
包括 输入 字段 ， 也 包括 DIV 及 文本 元 素 ， 如 了 P 和 SPAN 元 素 ) 是 可 视 组 件 。 客 户 端 
数据 绑 定 是 指 通过 JavaScript 直接 刷新 浏览 器 中 显示 的 Web 页 面 内 容 ， 而 不 必 从 
Web 服务 堪 重 新 加 载 页 面 的 技术 。 

本 章 将 介绍 和 比较 几 种 技术 ， 它 们 能 够 更 新 用 户 界 面 ， 并 更 好 地 反映 应 用 程序 
的 状态 。 最 人 徇 单 的 方法 是 从 服务 右 下 载 更 新 后 的 HIML 块 。 这 些 HTML 万 段 将 动 
态 蔡 换 现 有 的 HTML 片段 ， 从 而 对 当前 显示 的 页 面 进行 部 分 泻 染 。 另 外 一 种 方法 是 
丛 询 一 组 基于 JSON 的 疾 点 ， 获 取 最 新 数据 ， 从 而 完全 在 各 户 疹 的 JavaScript 中 重 
新 生成 HTML 布局 。 


12.1 通过 HTML 刷新 视图 


当 Web 页 耐 中 包含 丰 明 的 图 片 和 媒体 时 , 刷新 整个 页 和 面 对 于 用 户 来 说 上 有 定 会 很 
慢 、 很 及 烦 。 这 正 是 Ajax 和 部 分 泻 染 页 面 如 此 受 欢 迎 的 原因 。 在 页 面 泻 染 的 另 一 奖 ， 
是 单 页 应 用 程序 (Single Page Application，SPA) 的 概念 。 本 质 上 ，SPA 是 由 一 个 (或 少 
数 几 个 ) 极 简 的 HIML 页 面 构成 的 应 用 程序 ， 页 面 上 包含 一 个 几乎 为 空 的 DIV， 在 
运行 时 使 用 模板 和 从 某 个 服务 器 下 载 的 数据 填充 该 DIV。 从 服务 器 闹 泻 染 到 完全 由 
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客户 六 渔 染 SPA 的 这 条 路 上 ， 首 先 应 该 了 解 HIML 部 分 渔 染 方法 。 
12.1.1 准备 工作 


这 里 的 思想 是 , 任何 页 和 面 最 开始 完全 在 服务 器 问 处 理 , 然后 作为 一 块 HTML 下 
载 。 接 下 来 , 用 户 与 页 面 上 的 控件 之 间 的 任何 交互 都 通过 Ajax 调用 完成 。 被 调用 的 
端点 执行 命令 或 查询 ， 并 返回 纯粹 的 HIML 作为 响应 。 返 回 HTML 比 返 回 JSON 
数据 的 效率 低 ， 因 为 HIML 由 布局 信息 和 数据 构成 ， 而 在 JSON 流 中 ， 额 外 的 信息 
量 仅 限于 模式 ， 平 均 下 来 比 HIML 布局 数据 小 。 虽 然 如 此 ， 下 载 服 务 器 闹 泻 染 的 
HTML 介入 更 少 ， 并 且 不 需要 额外 的 技能 ， 也 不 需要 学 习 全 新 的 编程 模式 。 不 过 ， 
仍然 需要 用 到 一 些 JavaScript， 但 是 仅 限 于 使 用 熟悉 的 DOM 属性 (如 innerHTMI) 或 
一 些 核心 的 jQuery 方法 。 


12.1.2 ”定义 可 刷新 区 域 


页 面 上 需要 动态 刷新 的 区 域 必须 能 轻松 识别 ， 并 且 与 页 面 的 其 余部 分 隔离 开 。 
理想 情况 下 ， 这 个 区 域 应 该 是 一 个 带 有 已 知 ID 的 DIV 元 素 。 


<div id="1ist-of-customers"> 
<1-—— Place here any necessary HIML 一 一 > 
</div> 


为 DIV 下 载 了 新 的 HIML 后 ， 只 需要 使 用 一 行 JavaScript 代码 来 更 新 该 DIV， 
如 下 所 示 。 

$ ("#1ist-of-customers") .html (updatedHtml]l ); 

从 Razor 的 角度 看 ， 可 刷新 区 域 完全 是 用 分 部 视图 演 染 的 。 分 部 视图 不 只 使 结 
果 页 面 组 件 化 ， 加 强 重 用 和 关注 点 隔离 ， 而 且 更 容易 在 客户 闯 刷 新 页 面 的 一 部 分 ， 
而 不 需要 重新 加 载 整个 页 面 。 


<div id="1]ist-of-customers"> 
QHtml .Partial ("pv listoOfCustomers") 
</div> 


还 缺 一 个 控制 器 操作 方法 ， 用 来 执行 查询 或 命令 操作 ， 然 后 返回 分 部 视图 生成 
的 HTML。 


12.1.3 ”综合 运用 


假设 有 一 个 示例 页 面 ， 泻 染 了 一 个 客户 名 称 列表 。 任 何 有 权限 查看 页 面 的 用 户 
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都 可 以 单 击 一 侧 的 按钮 来 删除 当前 行 。 如 何 编写 相关 的 代码 ? 老 方 法 是 将 删除 按钮 
链接 到 一 个 URL， 在 该 位 置 ，POST 控制 器 方法 执行 删除 操作 ， 然 后 午 定 癌 到 GET 
页 面 , 用 最 新 数据 泻 染 页 面 。 可 以 这 样 做 , 但 是 需要 用 到 一 个 请 求 链 (Post-Redirect-Get)， 
而 且 更 重要 的 是 ， 这 会 导致 整个 页 面 重新 加 载 。 对 于 数据 量 大 的 页 面 一 一 现实 网 站 
中 几乎 每 个 页 面 的 数据 量 都 很 大 一 一 这 种 方法 衣 定 很 麻烦 。 

可 刷新 区 域 允许 用 户 单 击 按钮 ， 让 JavaScript 代码 发 出 POST 请 求 ， 并 显示 
HTML。 发 出 删除 客户 的 请 求 的 处 理 程序 将 收 到 一 个 HIML 片段 ， 并 用 其 巷 换 现 有 
的 客户 列表 。 


1. 操作 方法 


控制 磊 操 作 方法 没有 什么 特殊 的 ， 上 只 不 过 返回 的 是 分 部 视图 而 不 是 完整 的 视图 
结 霖 。 因 此 ， 这 种 方法 只 十 用 来 编辑 给 定 的 视图 。 要 跳 过 不 想 要 的 调用 ， 其 全 可 以 
用 目 定 义 短 选 硕 特 性 来 修饰 方法 ， 如 下 所 未 。 


[AJjaxOnlyl| 
[RequireReferrer("/home/index", "/home™", ™"™/")] 
[HttpPost]| 
[ActionName ("d")]| 
public ActionResult DeleteCustomer (int id) 
{ 
// Do some work 
Var model = DeleteCustomerAndReturnModel (1i1d);}; 


// Render HTML back 
return PartialViewl("pv listofcustomers", model); 


} 


AjaxOnly 和 RequireReferrer 是 目 定 义 师 选 占 (请 参见 本 书 的 配伍 代码 )， 只 有 请 
求 是 通过 Ajax 发 出 并 且 来 日 给 定 来 源 的 时 候 , 才 运 行 方法 。 另 外 两 个 特性 要 求 使 用 
POST 调用 ， 并 且 操 作 名 称 为 d。 


2. 方法 的 啊 应 


通过 Ajax 友 出 调用 时 ， 浏 览 亏 将 收 到 一 个 HTML 户 段 ， 并 用 其 符 换 可 刷新 区 
域 的 内 容 。 下 面 给 出 的 示例 代码 可 以 绑 定 到 单 击 按钮 的 操作 。 


<script type="text/javascript"> 
function delete(id) 1 
Var url = "/home/d/"; 
$.post (url, { id: id }) 
-done (function (response) 

// In this context, the parameter "response™" is the 
// method response. Hence, it is the fragment of HTML 
// returned by the action method via PartialView() . 
$ ("#1istOfCustomers") .html (response); 
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对 于 用 户 来 说 ， 体 验 非 党 好。 例如， 用户 单 击 列表 中 的 一 项 ， 列 表 束 会 立即 刷 
新 ， 反 映 用 户 做 出 的 修改 ， 效 果 如 图 12-1 所 示 。 在 图 中 ， 左 侧 的 屏幕 显示 用 户 单 击 
攻 一 行 的 删除 按钮 ， 右 侧 的 屏 禹 显示 了 删除 该 行 后 的 客户 列表 。 


器 localhost X 十 x 回 localhost x 


人 ) localhost:5054 “a 全 二 localhost 505. 


ft customers List of customers 


1 Customerz31 -45 AVMWLNPYR Customer=231 5 AVMWLNPYR 
9 Customer-459 -10 QSXTUVYNBJTP 9 Customer-459 10 QSXTUVYNBJTP 
) Customer-850 C15 UJRFTCPCYQTEGE 930 Customer=930 45 ALRVTHTAYV 
0 Customerg30 45 ALRWTHTAW CUStOMer-96s 1 JFEVMJSXPA 


8 Customer-968 1 JFVMJSXPA 


图 12-1 在 更 新 后 ， 刷 新 页 面 的 一 部 分 
3. 技术 的 局 限 


这 种 方法 效果 很 好 ， 但 是 一 次 只 能 更 新 一 个 HTML 片段 。 这 是 人 奋 真 的 是 局 限 ， 
取决 于 视图 的 本 质 及 其 实际 内 容 。 更 现实 的 情况 是 ， 在 服务 右 执 行 操作 后 ， 和 需要 更 
新 Web 视图 的 两 个 或 多 个 片段 。 

例如 ,在 图 12-2 所 示 页 面 删除 一 个 客户 时 ,需要 更 新 这 个 页 和 面 中 两 个 相关 联 的 
片段 。 不 只 要 更 新 表格 ， 移 除 已 经 删除 的 客户 ， 还 要 刷新 下 拉 列 表 。 显 然 ， 可 以 在 
控制 占 中 使 用 两 个 方法 ， 每 个 方法 返回 一 个 不 同 的 片段 。 这 就 需要 添 加 如 下 所 示 的 
代码 。 


<script type="text/javascript"> 
function delete(1id) | 
Var url = "/home/d/"; 
$.post(url, { id: id }) 
-done (function (response) | 
$ ("#1istoOfCustomers") .html (response); 
$ .post("home/dropdown", "") 
.done (function (response) { 
$("#dropdownCustomers") .html (response).， 
}); 
}); 
} 


</script> 
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拓 相间 localhost 


二 全 (从 localhost:: 


List of cuUstomers Operating on behalf of ~ 


Customer=105 

Customer-10 Customer-442 LXEIWZPBWATEJ 

Cusiomer44 USiOmerog1 BSAHRLVIGODE 
Customer-697 

Customer-68 ICCLNXXHSD 
Customer-821 


CUustomer-697 49 KLSAVTTY 


Customer-821 2b WYELATCLSSPGE 


图 12-2 Web 页 面 中 有 了 两 个 相关 的 HIML 卢 段 需要 更 新 


在 收 到 第 一 个 啊 应 后 ， 发 出 第 二 个 Ajax 调用 来 请 求 第 二 个 HTML 卢 段 。 不 过 ， 
还 有 更 好 的 方法 。 


4. 多 个 视图 操作 结果 类 型 


控制 右 方 法 返回 一 个 实现 了 TActionResult 类 型 的 类 型 ， 或 者 更 可 能 是 返回 的 类 
型 继承 了 ActionResult。 这 里 的 思想 是 ， 创 建 一 个 目 定 义 操 作 结 果 类 型 ， 使 其 返回 
一 个 由 多 个 HTML 片段 合并 而 成 的 字符 串 ， 每 个 HTML 片段 之 间 用 传统 的 分 隔 符 
阳 开 。 这 种 方法 有 两 个 优势 。 首 先 ， 使 用 一 个 HITP 请 求 可 以 得 到 任意 多 的 HTML 
片段 。 其 次 ， 工 作 流 更 加 简单 。 决 定 应 该 更 新 视图 的 哪些 部 分 的 逻辑 放 在 服务 器 端 ， 
客户 痛 只 接收 HIML 睛 段 的 数组 。 客 尸 站 仍然 需要 包含 必要 的 UI 馆 辑 ， 以 便 将 每 
个 HTML 片段 放 到 合适 的 位 置 。 但 是 ， 通 过 构建 一 个 自 定义 框架 ， 可 以 进一步 减轻 这 
项 工作 ， 该 目 定义 框 娘 以 声明 的 方式 将 一 个 卢 段 链接 到 客户 靖 DOM 中 对 应 的 HTML 
元 素 。 目 定义 操作 结 采 类 型 的 C# 关 如 下 所 未 。 

Public class MultiplePartialViewResult : ActionResult 

Public const string ChunkSeparator = "™"——— ||1|-———"; 


Public IList<PartialViewResult> PartialViewResults { get; } 


Public MultiplePartialViewResult (params PartialViewResult[] results) 


{ 
ift (PartialViewResults == nullj,) 
PartialViewResults = new List<PartialViewResult>();}; 
foreach (var T in results) 
PartialViewResuilts.Addl(r);:; 
} 


Public override async Task ExecuteResultAsync (ActionContext context) 


{ 
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if (context = null) 
throw new ArgumentNullException (nameof (context)); 


Var Services = context.HttpContext.RequestServices; 
Var executor = services.GetRequiredService<PartialVijewResultExecutor> () ， 


Var total = PartialViewResuilts.Count:; 
Var writer = new StringWriter (); 


for (var index = 0; index < total; indext+t+) 
L 
Var pv = PartialViewResults|[index|;} 
Var Vijew = executor.FindView (context, pV) .View; 
Var VviewContext = new ViewContext (context, 
VieWw, 


pv.ViewData, 
pvY.TempData, 
WwIiter, 
new HtmlHelperOptions ());} 
awalt Vview.RenderAsync (ViewContext); 


if (index < total 一 1) 
awalt writer.WriteAsync (ChunkSeparator); 


awalt context.HttpContext.Response .WriteAsync (writer.ToString ()); 
} 
操作 结果 类 型 包含 一 个 PartialViewResult 对 象 的 数组 ， 并 逐个 执行 它们 ， 在 内 
绥 冲 区 中 时 加 HTML 标记 。 完 成 之 后 ， 将 该 缓冲 区 刷新 到 输出 流 中 。 通 过 传统 但 
随意 决定 的 子 字 符 串 ， 分 隔 每 个 PartialViewResult 对 象 的 输出 。 
值得 注意 的 地 方 是 如 何在 控制 器 方法 中 使 用 这 个 目 定 义 操 作 络 果 关 型 。 重 与 
DeleteCustomer 操作 方法 ， 代 人 码 如 下 所 示 。 
[AJjaxOnlyl| 
[RequireReferrer("/home/index", "/home™, "/")] 
[HttpPost] 


[ActionName("d")]| 
Public ActionResult DeleteCustomer (int 1d) 


是 


{ 
// Do some work 
Var model] = DeleteCustomerAndReturnModel (id); 
// Render HTML back 
Var result = new MultiplePartialViewResult( 
PartialView("pv listoOfCustomer", model), 
PartialView("pv onBehalfoOfcustomers", model)); 
return result; 
} 


MultiplePartialViewResult 类 的 构造 图 数 接受 一 个 PartialViewResult 对 象 的 数组 ， 
所 以 可 以 在 调用 中 添加 任 总 多 个 该 对 象 。 
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最 后 ， 客 户 端 页 面 中 的 HTML 代码 也 稍 有 变化 。 


<Sscript type="text/javascript"> 
function delete(id) 1 
Var url = "/home/d/"; 
$.post(url, { id: id }) 
-done (function (response) 
Var chunks = Ybq.processMultipleA jaxResponse (response);} 
S$ ("#1istofCcustomers") .html (chunks [0]); 
$ ("#dropdownCustomers™") .html (chunks [1]); 
}); 
} 


</script> 


JavaScript 图 数 Ybq.processMultipleAjaxResponse 的 代 但 不 多 ， 它 只 是 在 传统 分 
隅 符 的 位 置 分 割 接 收 的 字符 串 。 人 代码 很 简单 ， 如 下 所 示 。 疼 12-3 显示 了 其 效果 。 
和 司 | 吕 localhost 


二 一 0) 全 localhost:50543 


List of customers Operating on behalf of ~ 


Customer-143 

Customer-143 “Customer-J85 PUT 

customer 385| usomer334 JPZHKADIBNMUTCA 
Customer=d439 

Customer-394 STSXIMPMLCUOTX 
Customer=892 


Customer-439 41PHGODKYCLY 


Customer-892 dz EJBGXLWIEQN 


秆 ” 司 | 电 localhost 


二 一 上 合 localhost:50543 


Le 


List of customers Operating on behalf of = 


Customer-143 

Customer-143 Customer-385 PUT 

Customer-385| “ustomer4yY IPZHKADIBNMUTCA 
Custiomer-892 

Customer=439 my | 


Customer-892 32 EJBGXLWIEQN 


图 12-3 ”同时 更 新 多 个 HTML 片段 


Ybhq.processMultipleAjaxResponse = function (response) | 
Var chunkSeparator = "———|||---"; 
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Var tokens = response.split (chunkSeparator); 
return tokens; 


3 


12.2 ”通过 JSON 刷新 视图 


SPA 应 用 程序 是 在 HIML 模板 上 构建 的 ， 并 使 用 指令 告诉 运行 时 如 何 修改 DOM.。 
指令 通 第 是 由 某 个 内 置 的 JavaScript 模块 处 理 的 HTML 特性 。 指 令 可 以 很 复杂 ， 包 
含 链接 在 一 起 的 格式 化 程序 和 筛选 器 。 另 外 ， 指 令 有 时 候 可 能 需要 引用 核心 语言 欣 
作 ， 例 如 检查 条 件 或 运行 循环 。Angular 等 框架 采取 的 方法 是 在 客户 端 构建 应 用 程 
序 ， 从 而 避免 了 草率 地 动态 重建 HIML 模板 来 显示 刷新 后 的 数据 。 

最 终 ， 当 刷新 页 面 的 一 个 部 分 时 ，Angular 动态 构建 字符 串 ， 并 使 用 DOM 命令 
来 显示 。 但 是 ， 可 以 用 一 个 小 得 多 的 框架 实现 相同 的 效果 ， 只 要 该 框架 能 够 在 负面 
中 和 藤 入 HTML 模板 ,并 知道 如 何 用 绑 定 的 数据 填充 该 模板 即 可 。 除了 这 个 基本 点 以 
外 ，Angular 这 样 的 大 框架 与 手动 编写 字符 串 的 构建 右 相 比 ， 区 别 只 在 于 提供 的 功 
能 数量 不 同 。 


12.2.1 Moustache.JS 库 简 介 


Mustache 是 用 于 创建 文本 模板 的 一 种 语法 ,但 不 包含 人 远 辑 。 它 可 以 用 于 生成 任 
何 文本 ,如 HIML XML 、 配 置 文件 以 及 所 选择 使 用 语言 的 源 代 码 。 简 言 之 ,Mustache 
能 够 扩展 模板 中 的 标签 以 包含 提供 的 值 ， 从 而 生成 任何 文本 。Mustache 是 没有 逻辑 
的 ， 因 为 它 不 文 持 控制 流 语 多 ， 如 正 语句 或 循环 。 在 某 种 程度 上 ， 其 功能 在 概念 上 
类 似 于 在 C# 代 人 码 中 使 用 String.Format 调用 。 

Mustache 模板 包含 在 Mustache.JS 库 中 ， 这 个 库 接受 JSON 数据 ， 然 后 在 提供 
给 它 的 模板 中 扩展 标记 。 

1. Mustache 语法 的 关键 

Mustache 语法 用 于 要 填充 的 文本 模板 ,主要 围绕 两 类 主要 的 标记 : 变量 和 有 。 
标记 的 类 型 还 有 很 多 ， 但 这 两 类 是 最 主要 的 。 更 多 信息 请 访问 http://mustache. 
github.io。 变 量 采 取 的 形式 如 下 所 示 。 

{1{ variable name 上 上 

际 记 是 绑 定 上 下 文中 的 数据 的 占 位 符 ， 可 映射 到 变量 名 。 映 射 是 以 递归 的 方式 
进行 的 ， 即 当前 的 上 下 文 将 回 上 过 历 到 项 部， 如 果 没 有 找到 匹配 项 ， 则 不 进行 任何 
演 染 。 下 面 给 出 了 一 个 例子 : 
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<p> 
<b>{{ lastname }1}</b>, 
<span>{{ firstname }}</span> 


</p> 
现在 ， 假 设 将 上 和 耐 的 模板 绑 定 到 下 和 而 的 JavaScript 对 象 : 
{ 


"firstname™”: "Dino", 
"Jastname"”: "Esposito"™ 


} 
最 终结 来 如 下 所 未 。 


<p> 
<b>Esposito</b>, 
<span>Dino</span> 
</p> 


天 认 情况 下 , 将 以 转 义 形式 渔 染 模板 中 的 文本 。 如 有 果 想 要 得 到 未 转 义 的 HIML， 
裔 要 另外 湛 加 一 对 大 括 写 {{{ 未 转 义 }}}。 

Mustache 的 和 会 多 次 洽 染 给 定 的 文本 块 ， 对 于 绑 定 集合 中 友 现 的 每 个 数据 元 素 
都 会 泻 染 一 次 。 每 个 节 以 # 符 号 开始 ， 以 /符号 结束 ， 这 与 HIML 元 素 的 结束 方式 相 
同 。# 侍 号 后 面 的 字符 串 是 键 值 , 用 来 标识 要 绑 定 的 数据 , 并 在 后 面 决 定 最 终 的 输出 。 


<UJ]> 
{{ #customers }} 
<1li>{{ lastname }}</l1i> 
{{ /customers }} 

</ul> 


如 果 绑 定 到 一 个 JavaScript 对 象 ， 该 对象 有 一 个 子 集合 customers， 了 于 集合 中 的 
每 个 成 员 都 有 一 个 lastname 属性 ， 则 模板 可 以 返回 如 下 所 示 的 内 容 。 


<ul> 
<]1i>Esposito</1i> 
<l1i>Another</l1i> 
<]i>Name</1i> 
<li>Here</1i> 
</ul> 


节 的 值 也 可 以 是 JavaScript 函数 。 此 时 ， 将 调用 该 函数 ， 并 把 它 传递 给 模板 体 。 
{{ #task to perform }} 


{{ book }} is finished. 
{{ /task to perform }} 


在 这 里 ，task to perform 和 book 都 应 是 绑 定 的 JavaScript 对 象 的 成 员 。 
{ 
"book™”: “Programming ASP.NET COFEe 


"task to Perftorm : function() I 
return function (text, render) 1 
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return "<h1>" + render (text) + "</h1l>" 
} 
} 
} 


最 终 的 输出 是 一 些 HTML 标记 , 在 Hl 元 素 中 包含 短 句 “Programming ASPNET 
Core is finished 。 

gh 节 的 键 之 前 的 ^ 符 号 指出 ， 对 于 键 值 的 相反 值 使 用 此 模板 。 使 用 人 ^ 和 从 号 的 
营 见 场景 是 在 过 到 空 集合 时 泻 染 一 些 内 容 。 


{{ #customers }} 
<b>{{ companyname }}</b> 
{{ /customers }} 
{{ “customers }} 
No customers found 
{{ /customers }} 


虽然 Mustache 的 语法 并 不 全 面 , 但 是 已 经 履 盖 了 最 常见 的 数据 绑 定 场景 。 下面 
看 看 如 何在 代码 中 将 JSON 数据 附加 到 模板 。 


2. 将 JSON 传 远 给 模板 


通过 使 用 经 典 的 SCRIPT 元 素 的 变 体 ， 在 Razor 视图 (或 普通 HTML 页 面 ) 中 骸 
入 Mustache 模板 。 


<SCIipt type="x-tmpl-mustache”" id="template—-details"»> 
<1—— Mustache template goes here 一 一 > 
</script> 


type 特性 被 设 为 x-tmpl-mustache， 这 可 防止 浏览 器 处 理 模板 。 还 给 了 SCRIPT 
元 素 一 个 唯一 ID， 用 来 在 代 人 中 检索 模板 的 内 容 。 


<script type="text/javascript"> 
var template = 3('#template-details') .html ();} 
Mustache .parse (template); // optional, speeds up future uses 
</script> 


模板 变量 包含 了 SCRIPT 元 素 的 内 部 内 容 ， 即 Mustache 模板 源 。 下 和 耐 这 个 示例 
返回 给 定 国家 的 信息 。 


<SCIript id="template—details™” type="x-tmpl-mustache"> 
<div class="panel panel-primary"> 
<div class="panel-heading"> 
<h3 class="panel-title">»> 
{ {Results .Name}} 
</h3> 
</div> 
<dliv class="panel--body"> 
<div class="col-xs-8"> 
<p>Capital is <strong>{{Results.Capital.Name}}</strong></p> 
<p>Phone international prefix is <strong>+{{Results.TelPrefl}} 
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</strong></p> 
</div> 
<div Class=" "col—xs—4"> 
<button id="btnGeo"™ 
type="button™" 
class="btn btn-—info™ 
data-toggle="collapse" 
data-target="#geo™"> 
More 
</button> 
<div id="geo™" class="collapse pull-right"> 
</div> 
</div> 
</div> 
</div> 
</script> 


作为 示例 ， 可 考虑 页 面 列 出 了 一 些 国家 ， 并 提供 了 每 个 国家 的 链接 ， 以 了 解 更 
多 信息 。 


<table class="table table-condensed"> 
Qforeach (var c In Model.CountryCodes) 


{ 
<tIr> 
<td>@c</td> 
<td> 
<button class="btn btn-—xs btn—info™ 
onclick="i("'@Cc"')}) "> 
<span class="fa fa-chevron-right"></span> 
</bputton> 
</td> 
</tr> 
} 
</table> 


单 击 按钮 将 运行 下 面 的 JavaScript 函数 : 


<script type="text/javascript"> 
function 1{(1d) 1 
Var url = "/home/more/";} 
$.getJSON (url, { id: id }) 
-done (function (response) 
Var rendered = Mustache.renderltemplate, response);}; 
$s$ ("#details") .html (rendered); 
}); 
} 


</script> 


template 表达 式 是 之 前 计算 过 一 次 并 预 解 析 的 Mustache 模板 ， 以 加 快 后 续 成 功 
调用 的 速度 。 通 过 调用 Mustache.render 方法 获得 最 终 的 HIML 标记 。 


3. 综合 运用 
图 12-4 显示 了 一 个 示例 页 面 。 单 击 国家 按钮 ， 用 户 将 远程 调用 一 个 端点 ， 该 端 
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点 将 检索 关于 国家 的 更 多 信息 ， 并 将 这 些 信息 作为 JSON 数据 返回 。 然 后 ， 通 过 
Mustache 模板 将 数据 绑 定 到 视图 。 


电 坦 | 己 localhost x + Y 


httpy/ocalhost:50543/ 


List of countries 


Capital is Rome 


Phone international prefix is +39 


图 12-4 用 于 渲染 选 定 国家 详细 信息 的 客户 端 模 极 
12.2.2 ” KnockoutJS 库 简 介 


Mustache 库 只 文 持 直接 绑 定 变量 和 无 逻辑 的 模板 。 换 名 话说， 使 用 Mustache 
的 节 时 ， 既 没有 条 件 表达 式 也 没有 更 复杂 的 循环 能 够 用 于 在 绑 定 的 集合 中 导航 。 这 
时 可 以 考虑 另外 一 个 库 : KnockoutJS 。 


1. KnockoutJS 库 的 关键 


KnockoutSs 与 Mustache 的 不 同 主要 表现 在 两 个 方面 。 首 先 ， 它 不 基于 单独 的 
模板 ， 其 次 ， 它 支持 更 丰富 的 绑 定 语法 。 在 KnockoutJS 中 ， 不 是 将 一 个 单独 的 模板 
转换 成 HIML， 然 后 插入 到 主 DOM 中 。 在 KnockoutJS 中 ， 模 板 就 是 最 终 视 图 的 
HTML。 但 是 ， 为 了 表达 更 加 丰富 的 语法 ，KnockoutJS 使 用 了 自己 的 一 套 HIML 上 自 
定义 特性 。 

这 个 库 另 外 一 个 关键 是 使 用 MVVM( 模 型 -视图 -视图 -模型 ) 模 式 将 数据 绑 定 到 
布局 。MVVM 模式 的 大 部 分 内 容 在 Mustache 的 编程 方法 中 也 可 看 到 ， 但 是 在 
KnockoutJS 中 ，MVVM 模式 更 加 清晰 。 在 KnockoutJS 中 ， 获 取 JavaScript 对 象 ， 
将 其 应 用 到 DOM 中 的 选 定 和 。 如 果 用 合适 的 特性 修饰 了 DOM， 那 么 将 应 用 
JavaScript 对 象 包含 的 数据 。 但 是 ， 在 KnockoutJS 中 数据 绑 定 是 双向 的 ， 这 意味 着 
会 将 JavaScript 代 但 应 用 到 DOM,， 反 过 来 , 对 DOM 所 做 的 修改 (例如 编辑 了 绑 定 的 
答 入 文本 框 时 ) 将 复制 到 JavaScript 对 象 的 映射 属性 。 
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2. 绑 定 机 制 


KnockoutJS 库 有 一 个 全 局 方法 ， 可 将 数据 附加 到 DOM 的 节 。 这 个 方法 瓯 是 
applyBindings， 它 接受 两 个 输入 参数 。 第 一 个 参数 是 包含 数据 的 JavaScript 对 象 ， 第 
二 个 参数 是 可 选 参数 ， 指 代 必须 把 数据 附加 到 其 上 的 DOM 的 根 对 象 。 数 据 绑 定 是 
通过 多 种 表达 式 实 现 的 ， 如 表 12-1 所 示 。 


表 12-1 KnockoutJS 库 中 最 重要 的 绑 定 命令 


描述 


attr 将 值 绑 定 到 父 元 系 的 指定 HTML 特性 。 
<a data-bind="attr:{ href:actualLink }">Click me</a> 
actualLink 表达 式 标 识 绑 定 对 象 上 的 有 效 表 达 式 (属性 或 图 数 ) 
CSS 将 值 绑 定 到 父 元 素 的 class 特性 。 
<hl data-bind="css:{ superTitle:shouldHilight }"></hl> 
shouldHighlight 表达 式 标识 绑 定 对 象 上 的 一 个 有 效 的 布尔 表达 式 。 如 果 值 为 
true， 则 将 指定 的 CSS 类 添加 到 class 特性 的 当前 值 上 
event 将 值 绑 定 到 父 元 素 的 指定 事件 。 
<button data-bind="event:{click:doSomething}">Click me</button> 
doSomething 表达 却 标 识 了 在 单 击 该 元 素 时 调用 的 函数 
style 将 值 绑 定 到 父 元 素 的 style 特性 。 
<hl data-bind="style:{ color:textColor }"></hl> 
textColor 表达 式 标 识 了 比 定 对 和 象 上 的 一 个 有 效 表达 式 , 该 表达 式 可 赋值 给 指定 
的 style 特性 
text 将 值 比 定 到 父 元 素 的 body。 
<span data-bind="text:1lastName"></span> 
lastName 表达 式 标 识 了 绑 定 对 象 上 的 一 个 有 效 表达 式 , 该 表达 式 可 赋值 为 元 又 
value 将 值 绑 定 到 父 元 素 的 value 特性 。 
<input type="text" data-bind="value:lastName"></input> 
lastName 表达 陈 标识 了 绑 定 对 象 上 的 一 个 有 效 表 达 陈 , 该 表达 式 可 赋值 为 输入 
字段 的 值 
Visible 设置 父 元 素 的 可 见 性 。 


<div qata-binqd="visipble:shouldBeVisiblen"> ... </div> 


shouldBeVisible 表达 式 标识 了 绑 定 对 象 上 的 一 个 有 效 布 尔 值 表达 式 


所 有 的 绑 定 命令 都 用 在 数据 绑 定 表达 却 内 ， 格 式 如 下 : 
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<hl data-bind="command:binding™" /> 


data-bind 特性 接受 的 表达 式 格 式 为 command:actual binding value。command 部 
分 标识 了 父 元 素 上 将 会 受到 影 啊 的 部 分 。actual binding value 代表 的 表达 式 在 计算 
后 得 到 实际 值 。 在 对 data-bind 特性 赋 相 同 值 时 ， 可 以 合并 多 个 绑 定 。 此 时 ， 用 各 与 
分 隅 各 个 绑 定 。 除 了 表 12-1 中 所 列 之 外 ， 还 有 其 他 绑 定 命令 , 但 是 它们 的 模式 与 表 
12-1 中 的 命令 相同 。 该 表 中 没有 列 出 的 命令 , 是 用 于 特定 HTML 特性 或 事件 的 特定 
绑 定 。 更 多 信息 请 访问 http:/knockoutjs.com。 


3. observable 属性 


observable 属性 是 KnockoutJS 库 一 个 相当 噩 级 的 功能 ， 在 绑 定 的 属性 发 生变 化 
时 提供 通知 。 用 observable 值 填充 JavaScript 对 象 的 属性 后 ， 每 当 这 个 值 发 生变 化 ， 
绑 定 到 该 属性 的 UI 元 素 都 会 自动 更 新 。 并 且 ， 由 于 KnockouJS 库 具 有 双向 性 ， 通 
过 UI 对 数据 绑 定 做 出 的 任何 修改 ,都 会 立即 在 内 存 中 的 JavaScript 对 象 上 反映 出 来 。 
Var author = 1 
firstname : ko.observable(" "Dino" ), 
lastname : ko.observable("Esposito"™), 


born: ko.observable(l1990) 
}; 


observable 属性 的 读 取 值 和 写 入 值 ， 语 法 上 稍 有 区 别 。 


// Reading an observable value 
Var firstName = author.firstname (); 


// Writing an observable value 
author.firstname ("Leonardo™ )})，: 


observable 的 值 也 可 以 是 计算 的 表达 式 ， 如 下 所 示 。 


author.fullName = ko.computed (function () 1{ 
return author.firstname() + "” "+ person.lastname (); 


}); 

比 定 到 UI 元素 后 ， 每 当 链 接 的 observable 的 值 发 生变 化 ， 计 算 表 达 式 也 将 自 
4. 控制 流 

KnockoutJS 库 有 两 个 主要 的 结构 来 控制 操作 流 : 直 命 令 和 foreach 命令 。 计 命令 


实现 了 条 件 控制 ，foreach 命令 则 为 绑 定 集合 中 的 所 有 元 素 重 复 应 用 一 个 模板 。 下 面 
显示 了 如 何 使 用 让 命令 。 


<div data—bind="if: customers.length > 0 > 
<1—— List of customers here 一 一 > 
</div> 


290 


第 12 章 各 忆 端 数据 绑 定 


只 有 当 customers 集合 不 为 空 时 ， 才 会 泻 染 DIV 元 素 体 。 站 命令 有 一 种 变 体形 
式 ifnot， 只 有 当 条 件 取 反 的 结 采 为 tue 时 ， 才 会 泻 染 输出 。 
foreach 命令 为 绑 定 到 和子 模 板 的 每 个 元 素 重 复 应 用 子 模 板 。 下 面 的 代码 显示 了 如 
何 填充 表格 。 
<div 1id="1listOfCountries"> 
<table class="table table-condensed™" data-bind="foreach:countryCodes"> 
<tIr> 
<td><span data-bind="text:$data™"></span></td> 
</tr> 


</table> 
</div> 


这 是 KnockoutJS 库 非 党 基本 的 使 用 方式 。 要 填充 表格 ， 需 要 使 用 JavaScript 调 
用 来 获取 JSON 集合 。 
<script type="text/javascript"> 
Var initUrl = "/home/countries"™; 
$ .getJSON (initUr], 
function (response) I 
ko.applyBindings (response); 
}); 


</script> 


这 段 代 人 码 在 员 面 加 载 时 运行 ， 从 茶 个 站 点 靖 点 下 载 一 些 JSON。 从 服务 堪 返 回 
的 JSON 将 被 传递 给 Knockout 模板 。 在 这 里 , countryCodes 是 返回 的 JSON 的 属性 。 
疹 点 与 Mustache 示例 中 使 用 的 端点 相同 。countryCodes 属性 是 一 个 何 单 的 字符 串 妆 
组 。 当 除了 直接 值 以 外 没有 需要 绑 定 的 属性 时 ， 使 用 $data 表达 式 。 


5. 综合 运用 


使 用 KnockoutJS 库 时 ， 需 要 的 思维 方式 与 使 用 Mustache 或 基本 的 服务 右 闹 数 
据 绑 定时 有 很 大 的 区 别 。 虽 然 Mustache 是 客户 端 绑 定 库 ， 但 是 在 泻 染 方面 ， 它 更 接 
近 经 典 的 服务 问 疹 版 本 ， 而 不 是 Knockouts 库 。 二 者 的 核心 区 别 在 于 语法 的 丰 遇 性 
和 对 MVVM 模型 的 文 持 程 度 。 

对 于 KnockoutJS 库 ， 所 有 操作 都 在 客户 端 完成 ,并 且 绑 定 到 数据 的 视图 模型 必 
须 在 客户 疹 作 为 JavaScript 对 象 泻 染 。 但 是 ， 对 MVVM 模型 的 丰富 文 持 ， 要 求 
JavaScript 对 象 既 包含 数据 ， 又 包含 行为 。 绑 定 的 每 个 事件 处 理 程序 都 需要 引用 视图 
模型 上 的 一 个 方法 。 如 何 获 得 对 象 的 实例 呢 ?” 最 方便 的 方法 是 在 客户 端 从 Razor 视 
图 引用 的 SCRIPT 块 中 定义 该 对 象 。 下 面 进一步 深化 前 一 个 示例 。 


<script type="text/javascript"> 


function CountryViewModel (codes) { 
this.countries = $.map(codes, function{(code) { return new Country (code); }); 
} 


function Country(lcode) { 
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“一 


this.code = Code:; 
this.showCapital = function() { 
Var Url = "/home/more/"™: 
$$.g9etJSON (url, { id: code |}) 
-Cone (function (response) | 
alert (response.Results.Capital .Name) :; 
}); 
} 
} 


</script> 
SCRIPT 块 定 义 了 CountryViewModel 包装 器 对 象 和 一 个 Country 帮助 程序 对 象 。 
用 来 填充 这 两 个 对 象 的 原始 数据 来 目前 面 在 Mustache 示例 中 使 用 过 的 服务 左 闯 点 。 
<SCTiPt type="text/javascript"> 
var initUrl = "“/home/countries"™; 
$ .getJSON (initUr]1, 
function (response) | 
Var model = new CountryViewModel (response.countryCodes),; 
ko.applyBindings (model)}; 
}); 
</script> 
上 和 耐 的 JavaScript 代码 负 贡 触发 实际 的 幢 面 填充 。 下 载 的 国家 代码 列表 被 包装 
到 CountryViewModel 对 象 中 ， 并 通过 KnockoutJS 库 应 用 到 整个 页 面 DOM。 在 
内 部 ， 包 装 器 对 象 创建 Country 对 象 的 列表 ， 每 个 国家 代码 对 应 一 个 Country 对 
象 。 添 加 这 个 步骤 ， 是 因为 期 望 用 户 界 和 面 会 生成 一 个 可 单 击 元 素 的 表格 ， 但 是 单 
击 处 理 程序 会 接收 一 个 绑 定 值 : 国家 代码 。 因 此 , 单 击 处 理 程序 必须 与 数据 绑 定 ， 
而 在 KnockoutJS 库 中 ， 单 击 处 理 程序 必须 是 绑 定 对 象 的 成 员 。Country 对 象 提供 了 
showCapital 方法 ， 从 对 象 的 内 部 状态 旋 取 当前 的 国家 代 人 但。 局 用 了 KnockoutJS 库 
的 Razor 视图 代码 最 终 如 下 所 未 。 


<table class="table table—-condensed™" data—bind="foreach:countries"> 


«TT 
<td data-bpbind="text:code"></td> 
<td> 
<button class="btn btn-—info” data-bind="event: {click:showCapitall}"> 
<i class="fa fa-~-chevron-—right"></i> 
</button> 
</td> 
</tr> 
</table> 


countries 属性 是 Country 对 象 的 数组 ，foreach:countries 命令 则 运 代 每 个 绑 定 的 
对 和 象 来 创建 TR 元 素 。 第 一 个 TD 元 系 在 元 素 体内 直接 显示 国家 代码 , 即 code 属性 。 
第 二 个 TD 元 系 包 含 BUTTON 元 素 ， 其 单 击 处 理 程序 与 绑 定 项 的 showCapital 方法 
绑 定 (如 图 12-5 所 示 )。 
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图 12-5 国家 页 面 的 KnockoutJS 库 版 本 


12.3 构建 Web 应 用 程序 的 Angular 方法 


几 年 前 KnockoutJS 库 出 现 的 时 候 ， 还 有 一 个 更 加 全 面 的 库 也 发 布 了 第 一 个 版 
本 ， 这 束 是 Angular 库 。Angular 有 的 最 独 版 本 是 Angular 4， 但 是 如 今 它 不 只 是 一 个 
用 来 方便 将 数据 绑 定 到 HIML 元 素 的 库 。 如 今 的 Angular 是 一 个 完善 的 框架 ， 用 于 
使 用 HIML 和 JavaScript 构建 Web 应 用 程序 。Angular 还 文 持 TypeScript, 后 者 最 终 
将 编译 为 JavaScript。 

Angular 由 多 个 库 构 成 ， 涵 震 了 从 数据 绑 定 到 路 由 和 导航 ， 以 及 从 HTTP 到 依 
赖 注 入 和 蛙 元 测试 的 请 多 方 和 面 。 使 用 Angular 设计 应 用 程序 的 方式 很 独特 ， 与 经 典 
的 ASPNET 开发 区 别 明显 。Visual Studio 2017 中 包含 一 个 内 置 的 模板 ,可 用 来 构建 
Angular 应 用 程序 。 如 果 使 用 该 模板 创建 应 用 程序 ， 然 后 租 看 生成 的 源 代 人 码 ， 将 看 
到 一 个 全 然 不 同 的 架构 , 它 由 两 类 模块 构成 :Angular 模块 和 JavaScript 模块 .Angular 
模块 或 多 或 少 可 类 比 为 ASPNET MVC 的 区 域 ， 而 JavaScript 模块 则 是 添加 的 功能 
块 ， 可 类 比 为 绑 定 的 NuGet 包 。 另 外 ， 还 有 一 些 组 件 相 当 于 ASPNET 的 视图 组 件 ， 
或 者 更 不 严 讶 地 说 ， 相 当 于 Razor 视图 。 在 组 件 内 ， 有 一 种 语法 提供 了 类 似 于 
KnockoutJS 库 的 MVVM 模型 的 一 僚 设 施 ， 可 以 使 用 模板 和 数据 绑 定 。 

Aneular 严格 依赖 于 NodeJS 和 npm。 在 Visual Studio 2017 外 部 ， 还 需要 使 用 
Angular CLI 生成 新 项 目的 上 骨架。 总 体 来 说 ，Angular 仍然 交付 Web 应 用 程序 ， 但 是 
其 提供 的 体验 和 采用 的 编程 方法 是 全 然 不 同 的 。 关 于 Angular 开 友 的 资源 有 很 多 。 
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不 过 ，https:/angulario 是 一 个 起 点 。 


12.4 ”小 结 


目前 ,用户 执行 操作 时 ， 如 果 刷 新 整个 页 面 ， 对 于 应 用 程序 来 说 是 沉重 的 负担 。 
十 几 年 衣 ，( 重 新 ) 发 现 Ajax， 生 出 了 一 个 新 的 技术 世界 ， 以 及 一 个 以 客户 端 数据 绑 
定 为 项 点 的 框架 。 总 体 来 看 , 现代 Web 应 用 程序 有 两 种 主要 的 方式 来 实现 客户 端 数 
据 绑 定 。 一 种 是 维护 一 个 服务 器 端的 、ASPNET 友好 的 结构 ， 使 用 更 多 动态 演 染 来 
丰富 各 个 视图 。 男 一 种 是 选择 一 种 完全 不 同 的 框架 ， 采 用 男 外 一 套 规则 。 

本 章 介 绍 了 第 一 种 方式 ， 提 供 了 3 个 不 同 级 别 的 解决 方案 。 首 先 ， 介绍 了 如 何 动 
态 下 载 服务 器 端 生 成 的 HTML 块 。 其 次 ， 集 成 了 一 个 极 小 的 客户 端 JavaScript 库 库 
(MustacheJS)。 了 最 后 ， 升 级 到 使 用 一 个 全 面 的 客户 冰 数 据 绑 定 库 ， 如 KnockouHUs 库 。 

实现 客户 端 数据 绑 定 的 另外 一 种 方式 要 求 使 用 非 ASPNET 框架 ， 如 Angular。 
这 不 是 说 不 能 将 ASPNET 作为 箱 主 环境 ， 将 Angular 集成 到 ASPNET 中 。 事 实 上 ， 
Visual Studio 2017 就 提供 了 Angular 模板 ,也 可 以 在 网 上 找到 许多 结合 使 用 Angular 
和 ASPNET Core 的 示例 和 评 件 。 但 是 , 构建 Angular 应 用 程序 需要 完全 不 同 的 技能 、 
实践 和 技术 ， 用 一 章 的 内 容 是 无 法 介绍 清楚 的 。 

第 13 章 将 介绍 Web 应 用 程序 前 端 ， 讨 论 如 何 构 建 对 设备 友好 的 视图 。 
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构建 设备 友好 的 视图 


如 果 别 人 不 给 你 照 镜 子 ， 自 己 的 鼻子 ， 你 又 能 看 到 多 少 ? 
一 一 父 院 克 * 阿 西贡 夫 , 《我 ， 机 器 人 》 


通过 议 备 连接 到 应 用 程序 的 用 户 ， 通 第 对 应 用 程序 的 体验 有 很 高 的 期 符 。 他 们 
期 望 网 站 提供 的 体验 能 够 接近 原生 的 iPhone 或 Android 应 用 。 例 如 ， 这 意味 着 网 站 
中 有 流行 的 小 组 件 ， 如 选择 列表 、 侧 边 妆 单 和 滑动 开关 。 这 些小 组 件 大 部 分 不 是 原 
生 的 HTML 元 素 ， 必 须 使 用 是 组 件 控件 来 模拟 ， 这 些 控件 每 次 输出 混合 在 一 起 的 
JavaScript 和 标记 。Twitter Bootstrap 和 jQuery 插件 的 效果 很 好 ， 但 是 还 不 够 ， 而 且 
无 论 如 何 ， 每 次 都 需要 做 一 些 工作 。 但 是 ， 正 如 第 6 章 所 述 ，ASPNET 标记 帮助 程 
序 能 够 提升 所 编 与 标记 的 抽象 程度 ， 并 在 内 部 将 其 转换 为 必要 的 HIMIL 和 
JavaScript， 上 所 以 能 够 大 大 减轻 这 个 问题 。 

啊 应 式 Web 设计 (以 及 Twitter Bootstrap 的 网 格 系 统 ) 是 男 外 一 个 强大 的 工具 ,能 
够 减轻 开发 负担 ， 不 必 为 给 定 的 网 站 专门 创建 一 个 移动 应 用 。 这 里 有 一 条 简单 的 准 
则 : 除非 业务 确实 要 求 ， 否 则 不 要 创建 移动 应 用 。 另 一 方面 ， 除 非 创 建 了 移动 应 用 ， 
售 则 不 要 忽视 如 何在 设备 (主要 是 智能 手机 和 平板 电脑 ) 上 提供 服务 。 如 果 在 一 开始 
就 忽视 了 设备 ， 那 么 很 可 能 不 会 走 到 业务 强烈 需要 一 个 原生 应 用 的 那 一 步 。 


13.1 根据 实际 设备 调整 视图 


以 最 合适 的 方式 使 用 HIML、CSS 和 JavaScript 创建 网 站 是 一 回 事 ;， 创建 一 个 
对 设备 友好 的 网 站 ， 使 其 看 起 来 像 是 原生 应 用 或 者 最 起 码 在 行为 上 像 原生 应 用 ， 是 
态 一 回 事 。 有 时 候 期 望 对 设备 友好 的 网 站 具有 完整 网 站 的 一 部 分 功能 ， 其 全 具有 不 
同 的 用 例 ， 这 会 使 问题 变 得 更 加 复杂 。 
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好 消息 是 ， 恰 当地 使 用 HTML 5， 可 以 减少 一 些 开发 问题 。 
13.1.1 _ HTML 5 在 开发 设备 应 用 方面 的 优势 


一 般 来 说 ， 在 设备 上 安装 的 浏览 器 都 能 很 好 地 文 持 HTML 5 的 元 素 ， 有 了 时 比 果 
面 浏览 筑 还 要 好 。 这 意味 看 至 少 在 智能 手机 或 平板 电脑 上 ， 可 以 默认 使 用 HTML 5 
元 素 ， 而 不 必 纠 结 迁 回 方法 和 边缘 情况 。 对 于 设备 友好 的 开发 ，HTML 5 有 两 个 方 
面 特别 重要 : 输入 类 型 和 地 理 位 置 。 


1. 新 的 输入 类 型 


不 同 的 日 期 、 数 字 甚 全 电子 邮件 地 址 之 间 有 看 巨大 的 区 别 ， 更 不 必 说 预定 义 的 
值 了 。 但 是 ， 目 前 的 HTML 似乎 只 能 支持 纯 文本 作为 输入 。 因 此 ， 开 发 人 员 就 要 阻 
止 用 户 输 入 无 效 字 人 从， 这 可 以 通过 对 输入 的 文本 进行 客 尸 病 验 证 实现 。jQuery 库 
的 几 个 插件 能 够 简化 这 个 任务 ， 但 是 这 反而 更 加 强调 了 一 个 要 点 ， 输 入 是 很 微妙 
的 问题 。 

HTMLS 为 INPUT 元 素 的 type 特性 提供 了 许多 新 值 。 男 外 , INPUT 元 素 还 具有 
儿 个 与 新 输入 类 型 相关 的 新 特性 。 下 和 而 给 出 了 一 些 例 子 : 

<input type="date™ /> 

<input type="time™ /> 

<input type="range™" /> 

<input type="number™ /> 

<input type="search™ /> 

<input type="color™ /> 

<input type="email" /> 

<input type="url™" /> 

<input type="tel™ /> 


这 些 新 输入 类 型 的 真正 效果 是 什么 呢 ? 期望 的 效果 是 ， 浏 贤 器 能 够 提供 一 个 专 
用 的 UI， 使 用 户 能 够 舒服 地 输入 日 期 、 时 间或 数字 ， 但 是 这 种 期 望 还 没有 被 彻 辰 标 
准 化 。 

果 面 浏览 器 并 不 总 会 采用 这 些 新 的 输入 类 型 ， 而 旦 提供 的 体验 也 不 是 始终 统一 
的 。 在 移动 设备 的 世界 ， 人 情况 就 好 得 多 。 重 要 的 是 ， 用 户 通常 会 使 用 移动 设备 的 默 
认 浏 览 句 来 浏览 Web。 因 此 ， 体 验 始终 一 样 ， 而 且 古 针对 具体 设备 的 。 

特别 是 ，email、url 和 tel 等 输入 字段 会 推动 并 能 手机 上 的 移动 浏览 右 目 动 调整 
键盘 的 输入 范围 。 图 13-1 显示 了 在 一 个 Android 设备 的 tel 输入 字段 中 输入 值 的 效 
果 : 键盘 默认 显示 数字 和 与 电话 有 天 的 符号。 

如 今 ， 并 不 是 所 有 浏览 占 都 会 提供 相同 的 体验 ， 虽 然 对 于 与 各 种 输入 类 型 相关 
的 用 户 界面 ， 这 些 浏览 锅 大 多 保持 一 致 ， 但 仍然 存在 一 些 关 键 的 区 别 ， 可 能 需要 开 
发 人 员 湛 加 日 定义 的 JavaScript 填充 代码 。 下 面 以 date 类 型 为 例 。Internet Explorer 
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或 Safari 的 各 个 版 本 都 没有 为 日 期 提供 特定 文 持 。 而 且 ， 残 日 期 而 襄 ， 移 动 设 备 上 
的 效 示 要 好 得 多 ， 如 图 13-2 所 不 。 


“On 全 | 11:47 


Www.expoware.org/demos/INpUut. 


Cancel 


13-1 Android 智能 手机 上 的 tel 输入 字段 。 图 13-2 ”Android 智能 手机 上 的 date 输入 字段 


一 般 来 说 ， 新 生产 的 移动 设备 上 的 移动 浏览 器 都 能 很 好 地 支持 HIML 5 元 素 ， 
因此 开发 人 员 应 该 准备 好 使 用 合适 的 输入 类 型 。 


2. 地 理 位 置 


地 理 位 第 是 果 面 浏览 融和 移动 浏 哎 旧部 三 泛 文 持 的 一 种 HTML 标准 。 如 前 所 述 ， 
网 站 的 移动 版 本 有 时 沉 要 有 专门 的 用 例 ， 而 这 些 用 例 在 完整 版 本 的 网 站 上 是 没有 的 。 
这 种 情况 下 ， 网 站 的 移动 版 本 很 有 可 能 会 用 到 用 户 的 地 理 位 置 。 下 面 给 出 了 示例 代 但 。 


<script type="text/javascript" 
src="http://maps.googleapis.com/maps/api/js?sensor=true"></script> 
<script type="text/javascript"> 
function ijinitialize() ff 
navigator.geolocation.getCurrentPositionl 
showMap, 
functionl(e) {alert (e.message);l}, 
lenableHighAccuracy:true, timeout:10000, maximumAge:0 1});}; 


} 


function showMap (position) 1 
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Var point = new googdle.maps.LatLno( 
position.coords.latitude, 
position.coords.longitude).; 

Var myOptions = 1{ 

ZOom: le6, 
center: point, 
mapTypeld: google.maps.MapTypelId.ROADMAP 

}; 

Var map = new google.maps.Map (document .getElementByld{("map canvas"™), 

myOptijons); 

Var marker = new google.maps .Marker ({ 
position: point, 
map: map, 
title: "You are here™ 1}); 

} 
</script> 
<body onload="ijnitialize(}"> 

<div id="map canvas" style="width:100%; height:100%"></div> 
</body> 


此 页 面 辐 用 户 请 求 获取 地 理 位 苞 的 权限 ， 然 后 在 地 图 上 显示 设备 的 精确 地 理 位 管 。 


注意 : 

地 理 位 置 受 到 浏览 器 策略 的 控制 ， 这 些 策 略 通常 是 针对 每 个 网 站 单独 设置 的 。 
另外 要 注意 , Google Chrome 只 在 安全 网 站 (HTTPS) 上 支持 Google Maps 功能 . 因此 ， 
上 面 这 个 示例 的 地 图 部 分 可 能 不 会 起 作用 ， 不 过 可 以 选择 获取 纬度 和 经 度 . 


13.1.2 特征 检测 


横 回 思维 认为 检测 设备 是 很 难 的 , 进而 催生 了 啊 应 式 Web 设计 (Responsive Web 
Design，RWD)。 男 外 一 种 选择 是 获取 客户 问 可 用 的 一 些 基 本 信息 (如 浏览 右 窗 口 的 
大 小 ),， 设置 专门 的 样式 表 ， 并 相应 地 让 浏览 器 重新 调整 页 面 中 的 内 容 。 这 种 思维 方 
式 引 出 了 特征 检测 的 概念 ， 并 且 俊 生 了 流行 库 Modemizr 和 同样 流行 的 网 站 


http://caniuse.com.。 
1. Modernizr 的 工作 原理 


特征 检测 痛 后 的 思想 很 镜 单 ， 并 且 在 条 种 程度 上 很 智能 ， 其 全 不 需要 笑 试 检测 
所 请 求 设 备 的 实际 功能 。 实 际 上 ， 要 检测 所 请 求 议 备 的 实际 功能 十 分 烦琐 ， 也 很 困 
难 ， 甚 到 会 给 解决 方案 的 维护 市 来 严重 的 问题 。 

有 了 特征 检测 库 ， 就 能 够 通过 编程 检测 设备 ， 进 而 决定 显示 什么 。 这 不 是 检测 
用 户 代理 , 然后 盲目 地 判断 某 个 设备 不 文 持 给 定 功能 , 而 是 让 专门 的 库 ( 如 Modermizr) 
确定 当前 浏览 项 是 合 文 持 给 定 功能 ， 与 特 主 议 备 无 天 (参见 http://modernizr.com)。 

例如 ， 不 必 维 护 一 个 文 持 日 期 输入 字段 的 浏览 占 列 表 (及 相关 的 用 尸 代理 字符 
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串 )， 而 是 可 以 使 用 Modernizr 检查 当前 浏览 器 是 否 支持 日 期 输入 字段 。 下 面 给 出 了 
一 些 示 例 代 但。 
<script type="text/javascript"> 
Modernizr.loadl(t1 
test: Modernizr.inputtypes.date, 
nope: | ` ]Jgquery-ul-min-]s ， “jquery—ui.css"], 
complete: function () I 
$5('input[type=datel] ') .datepickerlt1 
dateFormat: ‘yy—mm-—dd'" 
}); 
} 
}); 
</script> 
上 上述 代码 让 Modemizr 测试 日 期 输入 类 型 ， 如果 测试 失败 ， 则 下 载 jQuery UI 文 
件 , 并 运行 complete 回调 函数 ,为 页 面 中 所 有 日 期 类 型 的 INPUT 元素 设置 jQuery UI 
日 期 选取 费 插 件 。 这 样 ， 束 可 以 在 页 面 上 使 用 HIML 5 标记 ， 而 不 管 最 终 用 户 看 到 
的 效 采 如 何 。 


<input type="date™ /> 


特征 检测 为 开发 人 员 提 供 了 一 大 优势 :开发 人 员 只 需要 设计 和 维护 一 个 网 站 。 
以 啊 应 性 方式 调整 内 容 的 工作 转移 给 了 图 形 设计 师 或 专用 库 ， 如 Modemizr。 


2. Modernizr 能 够 做 什么 


Modernizr 包含 一 个 JavaScript 库 ， 该 库 的 一 些 代码 在 幢 面 加 载 时 运行 ， 能 够 检 
查 当 前 浏览 器 是 否 提供 了 特定 的 HIML 5 和 CSS 3 功能 。Modemizr 通过 编码 返回 
其 检查 结果 ， 使 页 面 中 的 代码 能 够 得 询 Modernizr 库 ， 并 智能 地 调整 输出 。 

Modernizr 的 效果 很 好 , 但 是 在 为 移动 用 户 优 化 网 站 时 , 不 能 全 面 解决 所 面临 的 
众多 问题 。Modermizr 只 限于 能 够 用 JavaScript 函数 检测 到 的 特征 ， 而 这 些 特 征 可 能 
是 、 也 可 能 不 是 在 navigator 或 window 浏览 器 对 象 中 公开 的 。 

换 句 话说 ，Modernizr 无 法 告诉 你 设备 的 外 形 规则 , 也 无 法 告诉 你 设备 是 智能 手 
机 、 平板 电脑 还 是 智能 电视 。 当 浏览 器 最 终 公 开 用 户 的 设备 类 型 时 ，Modernizr 也 将 
能 够 添加 此 服务 。 通 过 对 Modernizr 的 结果 应 用 一 些 逻 辑 ， 能 够 “可 菲 地 猜测 ” 浏 
览 器 是 移动 浏览 器 还 是 桌面 浏览 器 。 但 是 ， 除 此 之 外 ， 也 做 不 了 什么 了 。 

因此 , 如果 确 实 需要 专门 针对 智能 手机 和 /或 平板 电脑 完成 一 些 操 作 , Modemizr 
提供 不 了 什么 帮助 。 

特征 检测 的 主要 优势 可 以 总 结 为 “一 个 网 站 适用 于 所 有 场景 ”, 但 是 这 个 优势 也 
可 能 成 为 劣势 。 你 真 的 只 想 要 一 个 网 站 吗 ? 真 的 想 在 智能 手机 、 平 板 电脑 、 手 提 电 
脑 和 智能 电视 上 提供 “相同 的 ”网 站 吗 ? 这 些 问 题 的 答案 肯定 是 视 各 个 公司 的 业务 
需要 而 定 的 。 一 般 来 说 ， 回 答 只 能 是 “ 视 情 况 而 定 ” 
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下 面 介绍 如 何 通过 用 户 代理 字符 串 ， 实 现 客户 端的 轻 量 级 设备 检测 。 
13.1.3 客户 端 设 备 检测 


为 移动 设备 优化 网 站 ， 通 闸 并 不 是 意味 看 让 用 户 获 得 与 其 最 喜欢 的 平台 上 的 原 
生 应 用 相同 的 体验 。 移 动 网 站 很 少 是 专门 针对 iOS 或 Android 操作 系统 的 。 相 反 ， 
移动 网 站 通 第 让 用 户 在 使 用 任何 移动 浏览 项 时 都 能 获得 民 好 的 体验 。 

目前 ， 要 确定 设备 是 台式 机 还 是 功能 次 之 的 设备 (如 手机 或 平板 电脑 )， 咒 探 用 
尸 代理 字符 串 是 唯一 可 徘 的 方式 。 


1. 手动 创建 用 户 代 理 字 符 串 


有 一 些 在 线 资源 为 检测 移动 浏览 亏 提 供 了 一 些 司 发 .它们 结合 了 两 种 核心 技术 : 
分 析 用 户 代理 字符 串 和 多 方 验证 浏览 器 navigation 对 象 的 一 些 属 性 。 可 以 访问 下 面 
的 URL 来 获得 更 多 信息 : 

© http:/www.qulrksmode.org/ls/detect.html 

® http://detectmobilebrowsers.com 

第 二 个 网 站 上 提供 的 脚本 使 用 一 种 技巧 性 很 高 的 正则 表达 式 ， 检 测 已 知 与 移动 
设备 相关 联 的 一 个 长 长 的 关键 字 列 表 。 这 个 脚本 很 有 效 , 能 够 用 在 多 种 Web 平台 上 ， 
包括 普通 的 JavaScript 和 ASPNET。 但 是 ， 它 有 了 两 大 缺点 。 

一 个 缺点 是 其 上 一 次 更 新 的 日 期 。 我 最 近 一 次 得 看 其 页 和 面 时， 更 新 日 期 是 2014 
年 。 当 你 谈 本 书 时 ， 可 能 有 了 新 的 更 新 ， 但 仍然 可 以 感受 到 ， 要 让 这 个 正则 表达 式 
是 最 新 的 ,不 但 成 本 蜗 ， 而 且 必 须 频 演进 行 处 理 。 更 不 要 说 ， 用 于 ASPNET 的 脚本 
是 基于 VBScript 的 普通 Web Forms 脚本 ， 与 ASPNET Core 不 兼容 。 

另 一 个 缺点 是 ， 访 脚本 只 是 笠 试 指出 ， 已 知 用 户 代 理 标 识 的 是 移动 设备 还 是 果 

面 设备 。 脚 本 中 不 包含 逻辑 ， 也 不 能 通过 编程 更 加 具体 地 识别 请 求 设备 属于 哪 类 设 
备 ， 以 及 有 什么 已 知 的 功能 。 

如 条 想 找 到 免费 的 客 尸 痛 解 决 方案 来 嗅 探 用 户 代 理 字 符 串 ， 建 议 了 解 一 下 
WURFL.JS( 参 见 http:/wurflio)。WURFL.JS 有 很 多 优势 ， 其 中 之 一 是 它 不 基于 任何 
正则 表达 式 ， 由 用 户 负责 使 其 保持 最 新 状态 。 


2. 使 用 WURFL.JS 


WURFL.JS 的 名 称 有 些 误 寻 人 ， 马 其 实 不 是 一 个 静态 的 JavaScript 文件 ， 可 以 
本 地 托管 或 者 上 传 到 云 网 站 。 精 确 地 说 ，WURFL.JS 是 一 个 HTTP 端点 ， 可 通过 
SCRIPT 元 素 链 接 到 自己 的 Web 视图 。 

因此 ， 要 获得 WURFL.JS 服务 ， 只 需要 在 需要 了 解 实 际 设 备 的 HTML 视图 中 
添加 下 和 面 的 代 公 即 可 。 
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<SCTiPt 七 Ype="teXt/]avascript" src="//wurfl.io/wurfl.j]s"></script> 


浏览 规 完 全 不 知道 WURFL.JS 闯 氮 的 本 质 。 浏 览 医 只 是 县 试 从 指定 的 URL 下 
载 并 执行 脚本 代码 。 收 到 请 求 的 WURFL 服务 器 会 使 用 调用 设备 的 用 户 代理 来 确定 
其 实际 具备 的 功能 。WURFL 服务 器 依赖 WURFL 框架 的 服务 ， 这 个 框架 是 一 个 强 
大 的 设备 数据 存储 库 和 跨 平 台 API，Facebook、Google 和 PayPal 都 在 使 用 。 
调用 前 述 HITP 端点 的 效果 是 将 日 定义 JavaScript 对 象 注入 训 遇 规 DOM。 下 面 
给 出 了 一 个 例子 : 
Var WUREL = { 
“complete device name : 1IPhone 1", 
"is mobile":false, 
“form factor”:"Smartphone" 
}; 
服务 占 端 病 点 接收 了 随 请 求 友 送 的 用 尸 代理 字 得 串 ， 并 对 其 进行 彻 撒 分 析 。 然 
后 ， 服 务 器 端 端 点 选择 三 条 信息 ， 并 将 JavaScript 字符 串 返回 给 客户 端 。 
表 13-1 提供 了 WURFL.JS 属性 的 一 个 列表 。 


表 13-1 WURFL、JS 属性 


complete device name 检测 到 的 设备 的 描述 性 名 称 。 名 称 中 包含 供应 商 信息 和 设备 
名 称 (如 iPhone 7) 
form factor 指明 检测 到 的 设备 的 类 别 。 这 些 类 别 包 括 : Desktop、App、 


Tablet、 Smartphone、 Feature Phone、 Smart-TV、 Robot、 Other 
non-Mobile 和 Other Mobile 
is mobile 如 果 为 tue， 表 明 设 备 不 是 昌 面 设备 


图 13-3 显示 了 对 一 个 公共 测试 页 耐 (http://www.expoware.org/demos/device.html) 
使 用 WUREFL.JS 的 效果 。 

在 性 能 方面 ，WURFL.JS 是 相当 高 效 的: 它 进 行 大 量 缓存 ， 并 且 不 会 实际 检查 收 
到 的 任何 用 户 代 理 。 不 过 , 在 开发 过 程 中 , 可 以 在 URL 中 添加 debug=true 来 关闭 缓存 。 


只 要 网 站 是 公众 可 用 的 ， 就 可 以 免费 使 用 WUREFL.JS 框架 。 但 是 ， 如 果 用 在 生 
产 中 ， 当 流量 很 高 时 ， 它 可 能 成 为 性 能 瓶颈 。 此 时 ， 可 能 需要 考虑 一 个 节省 更 多 带 
宽 、 并 且 提 供 了 更 长 的 设备 属性 列表 的 商用 选项 。 更 多 信息 可 访问 http://www. 


sclientiamobile.com. 


301 


302 


第 IV 部 分 前 端 


12:36 


expoware.ord 


TABLET 
APPLE IPAD AIR 


Not a desktop browser 


图 13-3 ”使 用 WURFL .JS 进行 设备 检测 
3. 混合 使 用 客户 端 检 测 和 响应 式 页 面 


WURFL.JS 可 用 在 许多 不 同 的 场景 中 ， 包 括 浏览 器 个 性 化 、 增 强 分 析 及 广告 优 
化 。 而 且 ， 前 端 开 发 人 员 不 可 能 在 服务 器 端 实现 设备 检测 ， 此 时 WURFL.JS 就 成 了 
救星 。 要 了 解 更 多 示例 ， 可 访问 WUREFL.JS 的 文档 : http://wurfl.io。 

下 面 简 单 考 虑 一 些 需要 利用 客户 端 设 备 检 测 的 场景 。 一 个 场景 是 将 大 小 和 内 容 
都 适合 设备 的 图 片 下 载 下 来 。 可 以 采用 下 面 的 代码 : 

<script> 

jf (WUREL.form factor == 证 ) {1{ 


$ ("#myImage") .attr ("src™, ™..."); 
} 


</ script> 
类 似 的 ， 可 以 使 用 WUREL 对 象 ， 如 果 请 求 设备 看 起 来 是 一 个 智能 手机 ， 束 于 
定 问 到 一 个 专门 的 移动 网 站 : 


<SCript> 
ff (WUREFL.form factor == ee ) {1{ 
window.location.href = ™ 
} 
</script> 


WURFL.JS 提供 了 关于 实际 设备 的 提示 信息 ， 但 是 ， 束 现在 而 言 ， 还 不 能 混合 
CSS 虹 体 租 询 和 外 部 信息 (如 特定 设备 的 细节 )。 用 实际 的 用 户 代 理 而 不 是 媒体 和 合 询 
参数 驱动 的 啊 应 式 设计 仍然 是 可 以 实现 的 ， 但 是 这 完全 需要 日 己 完 成 。WURFL.JS 
最 常见 的 使 用 方式 是 用 在 Bootstrap 或 其 他 任何 RWD 解决 方案 内 。 可 以 获得 设备 的 
细 方 ， 并 日 通过 JavaScript 能 够 局 用 或 禁用 特定 的 功能 ， 或 者 下 载 专门 的 内 容 。 
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注意 : 

: 在 本 书 的 配套 代码 中 , 有 一 个 示例 使 用 WUREL.JS 决定 将 用 户 定向 到 网 站 的 哪 
个 部 分 .该 示例 是 概念 证 明 , 但 是 可 以 扩展 到 以 下 场景 : 网 站 的 大 部 分 是 经 典 的 RWD 

网 站 ， 但 是 有 少量 区 域 是 基于 设备 的 外 形 规格 重复 的 。 


13.1.4 Client Hints 即将 问世 


Client Hints 是 一 个 即将 问世 的 草案 的 口语 化 名 称 ， 这 个 草案 将 为 浏览 器 和 服务 
伏 协 商 内 容 提供 统一 、 标 准 的 方式 。Client Hints 受到 了 广泛 采用 的 Accept-* HTTP 
头 的 局 发 。 在 每 个 请 求 中 ， 浏 览 占 还 会 发 送 一 些 额外 的 头 ， 服务 占 读 取 这 些 涉 ， 并 
能 够 根据 这 些 头 来 调整 要 返回 的 内 容 。 

在 草案 目前 的 厂 本 中 ， 可 以 用 头 给 出 期 望 的 内 容 宽度 和 客户 痛 最 大 下 载 速 度 。 
这 两 条 信息 已 经 足以 让 服务 问 认 识 到 我 们 如 今 面 临 的 严峻 情形 : 议 备 的 屏 攻 小 ， 连 
接 的 速度 慢 。 事 实 上， 大 部 分 情况 下 ， 知 道 设 备 是 智能 手机 还 是 其 他 类 型 的 设备 其 
全 不 太 重 要 。 如 今 ， 啊 应 的 内 容 很 可 能 得 到 不 销 的 效果 ， 只 是 连接 非 痢 慢 ， 议 备 ( 包 
括 老 的 iPhone 设备 ) 的 分 辨 率 非 党 低 ， 这 一 点 在 将 来 会 更 加 明显 。Client Hints 就 在 
朝 着 这 个 方向 发 展 ,下面 的 代码 示范 了 在 Web 视图 中 包含 一 些 客户 端 提示 的 简单 方 
法 。 其 中 的 meta 标记 可 代替 HTTP 啊 应 头 ， 让 服务 器 表明 其 文 持 客户 问 提 示 。 

<meta http-equiv="Accept-CH" content="DPR, Viewport-Width, Width"> 


天 于 Client Hints 的 早期 文档 以 及 为 交换 数据 定义 的 一 些 头 ,可 访问 http:/httpwg. 
org/http-extensions/client-hints.html。 


13.2 ”对 设备 友好 的 图 上 三 


对 于 任何 网 站 来 说 ， 融 质量 的 、 有 效 的 图 片 部 是 必须 要 承受 的 人 负担。 但是， 由 
于 图 片 的 必要 大 小 和 设备 的 计算 能 力 不 成 比例 (更 不 必 说 网 络 问 题 )， 癌 设备 提供 图 
厂 束 存在 一 些 问题 。 提 供 设 备 友 好 的 图 片 ， 在 本 质 上 意味 看 册 操 : 一 古 提供 氨 字 市 
来 说 大 小 合适 的 图 片 ， 二 是 对 图 片 进行 相应 的 心病 和 /或 大 小 调整 ， 使 图 片 适 合 其 上 
下 文 。 换 名 话说 , 提供 合适 的 图 片 既是 数量 ( 子 市 数 ) 问 题 , 又 是 质量 ( 乞 术 设计 ) 问 题 。 


13.2.1 PICTURE 元 素 


HTML 5 新 增 了 一 个 用 于 泻 染 图 片 的 元 素 : PICTURE 元 素 。 可 以 将 其 视 为 原来 
熟 入 的 IMG 元 素 的 超 集 。 其 语法 如 下 : 
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<plicture> 
<source media=" (min-width: 481px)" srcset="~/content/images/poppies md.jpg" 
class="1img-responsive"> 
<Source media=" (max—width: 480px)" srcset="~/content/images/poppies xs.jpg" 
class="img—-responsive"> 
<img src="~/content/images/poppies.jpg" alt="Poppies" 
class="img—responsijve"> 
</picture> 


使 用 PICTURE 元 素 时 ， 可 以 指定 在 给 定 断 点 处 显示 多 个 图 片 ， 而 不 必 只 使 用 
一 个 图 片 ， 然 后 根据 视 区 的 宽度 来 放大 或 缩小 该 图 片 。 由 于 每 个 确定 的 断 点 都 可 以 
有 目 己 的 图 片 ， 因 此 可 以 设计 不 同 的 图 卢 来 更 好 地 满足 艺术 设计 的 需求 。 在 网 13-4 
中 ， 可 看 到 上 面 的 代码 在 Microsoft Edge 中 的 效果 。 窗 口 顶 部 的 调试 栏 显 示 了 屏幕 
的 当前 宽度 。 宽 度 为 480 像素 时 ， 看 到 的 是 以 老 旧 的 乡村 建筑 物 为 中 心 的 XS 图 片 。 
宽度 为 481 像素 时 ， 图 片 改 为 显示 唉 聚 花 田 的 横 问 视图 。 
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图 13-4 ”PICTURE 元 素 在 Microsoft Edge 中 的 效果 


同一 图 片 经 过 调整 用 于 XS 和 MD 上 断 点 。 注 意 ， 虽 然 XS 和 MD 这 两 个 后 级 可 
能 让 你 想起 Bootstrap 的 断 点 ， 但 是 其 实 这 些 断 点 和 Bootstrap 的 断 点 没有 关系 。 只 
有 PICTURE 元 素 的 source 子 节点 的 media 特性 才 设 置 了 让 浏览 器 切换 图 片 的 条 件 。 

PICTURE 元素 膛 渐 被 接受 ， 但 还 不 是 所 有 浏览 右 剖 文 持 。 不 过 ， 在 Google 
Chrome、Opera 和 Microsoft Edge 最 近 的 版 本 中 可 以 使 用 PICTURE 元 又, 这 意味 看 
可 以 在 目 己 的 网 站 中 使 用 该 元 素 ， 而 不 需要 有 太 多 顾虑 。 对 于 开发 人 员 和 省 理 员 来 
说 ，PICTURE 元 素 寓 来 了 另外 一 个 不 小 的 问题 : 维护 同一 图 片 的 多 个 副本 ,以便 根 
据 当前 的 屏幕 大 小 使 用 合适 的 图 片 副 本 。 如 果 网 站 中 有 许多 需要 频繁 更 新 的 图 片 ， 
这 会 是 一 个 严重 的 问题 。 

对 于 多 分 辨 率 图 片 ， 另 一 个 选择 是 使 用 ImageEngine 平台 。 与 PICTURE 元 素 
不 同 ，ImageEngine 平台 没有 任何 莱 容 性 问题 。 
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13.2.2 ”ImageEngine 平台 


ImageEngine 是 一 个 商用 图 上 缩放 工具 ， 作 为 一 项 服务 提供 给 用 户 (参见 
http:/wurfLio)。 它 特别 适合 对 设备 友好 的 场景 ， 能 够 显著 降低 视图 的 图 片 负载 ， 从 
而 减少 加 载 时 间 。 这 个 平台 的 工作 方式 类似 内 容 交 付 网 络 (Content Delivery Network， 
CDN)， 它 位 于 服务 器 应 用 程序 和 客户 闫 浏览 器 之 间 ， 代 表 服 务 器 智能 地 提供 网 片 。 

ImageEngine 平台 的 主要 目的 是 减少 图 请 所 生成 的 流量 。 在 这 方面 ， 它 是 移动 
网 站 可 以 使 用 的 理想 工具 。 但 是 ，ImageEngine 的 用 途 不 限于 此 。 首 先 ， 它 可 以 用 
来 回 任 何 设备 提供 调整 过 大 小 的 图 片 ， 无 论 设 备 是 什么 类 型 。 其 次 ， 可 以 把 
ImageEngine 作为 一 个 在 线 的 、 具 有 基于 URL 的 编程 接口 的 图 片 大 小 调整 工具 。 最 
后 ， 可 以 将 ImageEngine 作为 目 己 的 仅 提 供 入 能 图 厂 的 CDN， 这 样 就 不 必 日 己 维护 
同一 图 片 的 多 个 版 本 ， 可 以 加 快 图片 在 各 种 尺寸 屏 融 上 的 加 载 速度 。 


13.2.3” 目 动 调 整 图 片 大 小 \ 


要 使 用 ImageEngine， 首 先 需 要 建立 一 个 账 尸 。 这 个 账户 用 账户 名 来 识别 号 份 ， 
帮助 服务 器 分 辨 不 同 用 户 的 流量 。 但 是 ， 在 创建 账户 之 前 ， 可 以 先 试用 测试 账户 。 
在 Razor 视图 中 ， 可 以 在 Web 页 面 中 显示 图 片 ， 代 人 码 如 下 所 示 。 

<img src="~/content/images/autumn.jpg"> 

使 用 ImageEngine 时 ， 可 以 用 下 和 而 的 内 容 巷 换 上 和 耐 的 标记 。 

<img src="//try.imgeng.in/http://www.yoursite.com/content/images/autumn .jpg"> 


有 J 了 了 目 己 的 账户 后 ， 就 可 以 将 try 和 蔡 换 为 目 己 的 账户 名 称 。 假 设 账 户 名 称 是 
contoso， 堵 么 图 厂 的 URL 就 变 为 : 


<imd src="//contoso.imgeng.in/http://www.yoursite.com/content/images/autum .jpg"> 


换 句 话说 , 需要 将 原 图 片 的 完整 URL 传递 给 ImageEngine 后 端 以便 能 够 悄悄 
下 载 和 缓存 图 片 。ImageEngine 支持 许多 参数 ， 包 括 裁剪 和 调整 大 小 ， 从 而 获得 指 
定 的 尺寸 。ImageEngine 不 仅 可 以 将 图 片 调整 为 它 认 为 最 适合 设备 的 大 小 ， 还 可 以 
接受 具体 的 建议 ， 如 表 13-2 所 示 。 表 13-2 的 URL 中 插入 了 参数 。 
表 13-2 ImageEngine 工具 的 URL 参数 
URL 参数 描述 
w NNN 设置 图 厂 的 期 望 宽度 (像素 数 ) 


示例 URL: //contoso.imgeng.in/w 200/IMAGE URL 
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( 续 表 ) 
URL 参数 摘 述 
h NNN 设置 图 片 的 期 望 高 度 (像素 数 ) 
示例 URL: //contoso.imgeng. in/h 200/IMAGE URL 
pe_NN 设置 图 厂 的 期 望 因 小 百分比 。 
示例 URL: //contoso.imgeng.in /pc 30/IMAGE URL 
m XXX 设置 图 片 调整 大 小 的 模式 。 可 用 的 全 包括 box( 扶 认 值 )、cropbox、 


letterbox 和 stretch 。 
示例 URL: //contoso.imgeng.in/m cropbox/w 300/h 300/ 


IMAGE URL 


{ XXX 设置 图 片 的 期 望 输出 格式 。 可 用 的 值 包括 png、jpg、webp、gif 和 
bmp。 默 认 情 况 下 ， 以 原始 格式 返回 图 上 厂 。 


示例 URL: //contoso.imgeng.in/ f webp/IMAGE URL 


注意 ， 宽 度 / 高 度 和 百分比 是 互 太 的。 如 果 没 有 指定 任何 参数 ， 将 把 图 片 缩放 为 
检测 到 的 用 户 代 理 建议 的 尺寸 。 可 以 把 参数 组 合 起 来 ， 作 为 URL 的 片段 。 例 如 ， 当 
图 片 的 原始 尺寸 不 能 返回 正方 形 时 ， 下 和 面 的 URL 将 从 图 片 的 中 心 开 始 ， 将 图 片 裁 前 
为 300X300 像素 。 参 数 的 顺序 并 不 重要 。 


//contoso.imgeng.in/w 300/h 300/m cropbox/IMAGE URL 


图 13-5 所 示 为 使 用 ImageEnegine 的 优势 。 在 智能 手机 上 显示 页 面 时 ， 图 片 的 尺 
寸 与 原始 图 片 不 同 。 示例 页 面 中 的 两 个 IMG 元 素 通 过 ImageEngine 指 回 相同 的 物理 
图 片 ， 被 直接 显示 出 来 。 


下 加 i 伟 Wl 10:29 


WW .expPOWAare. ord 
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图 13-5”ImageEngine 的 效果 
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<img id="imgl™" src="http://try.imgeng.in/http://www.expoware.org/images/ 
tennisl.jpg"” /> 
<img id="img2"™" src="http://www.expoware.org/images/tennisl.jpg™" /> 


与 PICTURE 元 素 相 比 ，ImageEngine 并 不 能 用 来 提供 真正 不 同 的 图 片 ， 所 以 如 
朱 涉 及 艺术 设计 问题 ， 束 需要 托 党 并 提供 物理 上 不 同 的 图 片 ， 而 它们 可 通过 
ImageEngine 做 进一步 的 预 处 理 。 但 是 ， 如 宁 不 需要 考虑 艺术 设计 ，ImageEngine 有 
助 于 减轻 手动 调整 图 片 大 小 的 负担 ， 并 能 够 节省 带宽 。 


13.3 面 回 届 备 的 开发 案 略 


到 目前 为 止 ， 我 们 讨论 了 一 些 简单 的 客户 站 技术 ， 用 于 在 各 种 充 备 上 改进 页 面 
的 泻 染 及 行为 。 接 下 来 扩展 到 整个 网 站 ， 了 解 有 哪些 方法 可 以 癌 设 备 提 供 内 容 。 


13.3.1 以 客户 端 为 中 心 的 策略 


到 目前 为 止 ， 介绍 的 内 容 主 要 围绕 看 对 负面 的 文档 对 和 象 模 型 做 出 的 JavaScript 
改进 。 下 面 总 结 一 下 可 以 采用 的 选项 。 


1. 响应 式 HTML 模板 


如 果 要 开始 创建 一 个 全 新 的 网 站 ， 现 在 会 建议 你 使 用 Bootstrap， 让 所 有 视图 都 
有 啊 应 式 模板 。 使 用 啊 应 式 HTML 模板 确保 了 当 用 户 调整 打 面 浏览 器 的 窗口 大 小 
时 ， 仍 然 能 够 很 好 地 显示 视图 ， 并 且 基 本 能 够 禾 讲 移动 用 尸 。 事 实 上 ， 移 动用 户 全 
少 能 够 收 到 加 耐用 户 在 调整 浏览 器 窗口 大 小 时 收 到 的 相同 视图 。 

也 许 从 性 能 的 角度 看 ， 这 不 是 理想 的 情况 ， 但 是 如 果 设 备 很 新、 很 快 ， 并 且 连 
接 也 不 差 ， 那 么 效果 是 可 以 接受 的 。 如 果 移 动 并 的 交互 是 业务 的 核心 部 分 ， 则 不 建 
议 对 网 站 采用 这 种 方法 ; 但 是 在 大 部 分 情况 下 ， 这 种 方法 是 可 行 的 。 

对 于 Bootstrap 或 更 常见 的 RWD 而 主 ， 主 要 的 问题 是 断 点 的 定义 ， 即 触发 视图 
改变 的 屏幕 宽度 。Bootstrap 有 目 己 的 一 组 断 点 ， 分 别 市 有 XS、SM、MD 和 LG 后 
缀 。 每 个 断 点 对 应 固定 的 像素 宽度 。 这 种 方法 大 多 数 时 候 有 效 ， 但 是 远 不 是 完美 的 
解决 方案 。 特 别 是 ，Bootstrap 的 断 点 系统 不 能 恰当 地 处 理智 能 手机 和 小 屏幕 设备 。 
XS 后 级 在 宽度 为 768 像素 时 人 触发， 但 是 这 个 宽度 对 于 智能 手机 来 说 太 宽 了 。 不 过 ， 
在 Bootstrap 4 中 ， 添 加 了 一 个 新 的 断 点 ， 将 可 识别 的 最 小 设备 宽度 设置 为 $00 像素 
左右 。 这 仍然 不 够 完美 ， 但 已 经 好 多 了 。 

另外 一 种 方法 是 根本 不 使 用 Bootstrap， 或 者 创建 一 个 完全 自 定义 的 网 格 系统 ， 
用 应 用 程序 特有 的 度量 来 符 换 Bootstrap 的 网 格 。 
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2. 添加 客户 端 增强 


如 末 时 间 和 预算 允许 ， 可 能 想 要 提高 啊 应 式 视 岁 的 质量 ， 优 化 啊 应 陈 视图 未 些 
部 分 (如 图 上 亡 ) 的 处 理 方 式 ， 并 且 在 检测 到 相应 的 设备 时 ， 局 用 未 些 移动 设备 特有 的 
功能 。 这 个 步 又 是 为 了 提供 最 好 的 用 户 体 验 ， 并 延伸 到 特征 和 设备 检测 。 下 面 的 未 
例 污 示 了 如 何 优 化 日 期 选取 这 个 看 起 来 微不足道 的 任务 ， 让 用 户 无 论 使 用 什么 设备 
都 能 获得 理想 的 体验 。 

<div class="col—xs—6"> 

REGULAR DATE-PICKER<br /> 
<input type="text" class="form-—control" date> 
</div> 

<div class="col—xs—6"> 

DEVICE-SPECIEIC DATE-PICKER<br /> 


<1input type="text"” class="form-—control™" id="mdate"™> 
</div> 


JavaScript 修改 了 上 述 代码 中 两 个 相似 的 INPUT 字段 。 市 有 目 定 义 date 特性 的 
INPUT 字段 将 被 附加 到 一 个 日 期 选取 占 插 件 。 而 对 于 男 一 个 INPUT 字段 ， 只 有 检 
测 到 的 设备 是 智能 手机 或 功能 手机 时 ， 才 会 将 其 type 特性 改 为 date( 例 如 , 平板 电脑 
使 用 日 期 选取 器 插件 )。 

<Script> 

// Blindly uses a date-picker. 
// For example, https://uxsolutions.github.io/bootstrap-datepicker 


("input [date] ") .datepicker (1 
/i/ More configuration 


// Datepicker or native 


jf (WUREL.form factor === "Smartphone™” || 
WURFEFL.form factor 一 一 "Feature Phone ) i 
$s ("#mdate™") .attr ("type", "date™); 
} else I 
$ ("#mdate") .datepicker () ; 
} 
</script> 


如 图 13-6 所 示 ， 在 智能 手机 上 ， 日 期 选取 器 组 件 用 起 来 并 不 是 特别 方便 。 在 平 
板 电 脑 上 也 许可 以 ， 但 是 对 于 小 屏 磊 设备 ， 原 生 选 取 器 的 效果 更 好 。 但 是 ， 必 须 动 
态 地 修改 type 特性 的 值 来 区 分 原生 的 和 编程 写 出 的 日 期 选取 器 , 并且 必须 检测 设备 
类 型 。 这 是 客户 疹 增 强 的 一 个 具体 示例 。 


3. 路 由 到 视图 


本 章 前 面 暗示 有 一 种 技术 能 够 根据 发 出 请 求 的 用 户 代理 ， 下 载 合 适 的 HTML。 
使 用 WURFLJS 可 以 检测 浏览 器 的 外 形 ， 然 后 从 服务 器 下 载 最 合适 的 内 容 。 这 要 求 
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每 个 视图 (或 最 关键 的 视图 ) 可 以 在 多 个 副本 使 用 ， 例 如 一 个 版 本 用 于 智能 手机 ， 一 个 
版 本 用 于 时 和 耐 浏览 融 。 下 面 的 代码 可 根据 检测 到 的 设备 ， 通 过 编程 确定 负面 的 内 容 。 


* 风 Oi 会 | | 12:09 


REGULAR JS DATE- DEVIGE-SPECIFIG 
PICKER DATE-PIGKER 


军 


/bootstrap- 


su Mo Tu We Th Fr Sa 
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13-6 ”在 党 能 手机 上 使 用 日 期 选取 费 并 不 方便 


<html> 
<head> 
<meta charset="utf-8™ /> 
<meta name~="viewport™ content="width=devijce~-width, jnitial-scale=l] .0"> 
<title>DEVICE DISCOVERY</title> 
<link href="content/styles/bootstrap.min.css" rel="stylesheet"type= 
"Text/css™ /> 
<Script src="content/scripts/jquery-—3.1.1 .min.js"></script> 
<Script src="content/scripts/bootstrap.min.j]s"></script> 
<Sscript src="//wurfl.io/wurfl.js?debug=true™"™></script> 


<script type="text/javascript"> 
Var formFactor = WURFL.form factor; 
Var agent = WURFL.complete device name; 
window.addEventListener("DOMContentLoaded", function () ff 
$ ("#title™") .html (formFactor + “<br>" + agent),;} 
}); 
</script> 
<Sscript type="text/javascript"> 
var url = "/screen/default"™; 
5 (document) .ready (function () { 
switch (formFactor) 1{ 
case "Smartphone”™: 


url = "/screen/smartphone"; 
break; 
case "Tablet™: 
url = "/screen/tablet™"; 
break; 
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} 
* -ajaxt(l 
url: url, 
cache: false, 
dataType: "html™, 
Success: function(data) 1{ 
$ ("#body") .html (data); 
} 
}); 
}); 
</script> 
</head> 
<body> 
< 一 一 Some more content here 一 一 > 


<div class="text—center 七 人 XL 一 WaTrnlITnG > 
<div id="title"></div> 

</div> 

<div id="body"> 
<div Class="text-—-center"> 

<span>LOADING ...</span> 

</div> 

</div> 

< 1 一 一 Some more content here 一 一 > 


</body> 
</html> 


HEAD 部 分 的 最 后 几 段 脚本 更 新 页 面 的 头 ( 使 用 普通 的 DOM APD 和 实际 的 内 容 
(使 用 jQuery APD。 这 里 使 用 了 不 同 的 API， 是 为 了 说 明 在 更 新 页 面 时 并 不 依赖 于 任 
何 API。 根 据 检 测 到 的 外 形 规格 ， 页 面 将 连接 到 站 点 特定 的 端点 ， 请 求 最 适合 的 
HTML 标记 块 .图 13-7 显示 了 平板 电脑 上 的 视图 (注意 ,在 Microsoft Edge 模拟 器 中 ， 
传 入 了 Apple iPad 用 户 代理 字符 串 ， 才 得 到 了 这 张 图 )。 

关 喝 电 DEVICE DISCOVERY 


3 ()》 人 向 Ilocalhost60748AWMultil 


Tablet 
Apple iPad 


This is the view you intend to display to users coming Your Way 
using a tablet browser. 


图 13-7 示例 页 和 面 在 平板 电脑 上 的 视图 


从 获得 多 个 视图 的 角度 看 ， 这 里 讨论 的 拉 术 是 有 效 的 ， 但 是 从 解决 方 生 的 灵活 
性 和 可 管理 性 的 角度 看 ， 它 就 没 那 么 有 效 。 仍 然 需要 创建 和 维护 同一 个 视图 的 多 个 
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副本 ， 而 且 需 要 修改 视 独 时 ， 必 须 更 新 所 有 副本 。 多 年 来 ， 我 一 直 夏 欢 为 移动 设备 
使 用 专门 的 视图 ， 但 从 长 远 来 看 ， 工 作 量 太 大 ， 如 果 时 间 和 预算 有 严格 限制 ， 那 么 
RWD(Bootstrap 是 其 先驱 ) 可 能 是 最 好 的 折 中 方案 。 


13.3.2 ”以 服务 器 为 中 心 的 策略 


要 改进 前 一 种 方法 但 仍然 获得 同一 饮 辑 视图 的 多 个 版本 ， 有 一 种 简单 的 方法 : 
在 服务 需 站 执行 设备 的 检测 。 但 是 ， 完 全 在 服务 需 痛 进行 检测 也 有 问题 。 


1. 服务 器 端 检测 


好 终 ， 服 务 占 病 检 测 束 是 分 析 浏 览 占 发 迹 的 用 尸 代理 字符 串 。 理 论 上 ， 只 需要 

用 正则 表达 式 分 析 用 户 代 理 凶 符 串 即 可 。 但 是 ， 由 于 现今 的 设备 数量 庞大 ， 用 户 代 
理 字 和 从 串 和 边缘 案例 众多 ， 所 以 如 果 设 备 检测 十 分 关键 且 和 需要 在 服务 占 问 进行 ， 最 
好 付费 使 用 专业 服务 。 
注意 : 
一 /| 我 使 用 的 框架 是 WURFL OnSite， 但 是 也 有 其 他 选择 ， 如 Device Atlas。 在 编写 

本 书 时 ，ASPNET Core 2.0 已 经 发 布 ， 所 有 设备 检测 服务 器 框架 的 一 大 问题 是 不 支 
持 .NET Core。 


在 等 待 服务 嚣 框架 移 植 到 .NET Core 的 过 程 中 ， 能 够 实际 运用 的 选项 如 表 13-3 
所 不 。 


表 13-3 ASP.NET Core 应 用 程序 内 可 以 使 用 的 服务 器 端 检测 选项 
AP| 摘 述 
WURFL Onsite .NET API | 。 在 为 完整 的 NET Framework 编 详 的 ASPNET Core 应 用 程序 中 
WURFL Cloud .NET API 。 将 API 包 攻 到 一 个 微服 务 ( 独 立 的 Web 服务)， 并 通过 HTTP 


从 ASPNET Core 调用 
更 多 信息 请 访问 http://www.scientiamobile.com 
Device Atlas NET API 同上 
WURFL InFuze 模块 WURFL InFuze 是 IIS 扩展 模块 ， 通 过 HTTP 头 将 配置 好 的 设 符 


属性 添加 到 每 个 请 求 中 。 在 这 个 方面 ， 它 完全 独立 于 .NET 
Framework 的 版 本 。 参 见 http://www.scientiamobile.com 


关键 在 于 ， 服 务 占 病 检 测 为 用 尸 提 供 了 最 好 的 体验 ， 因 为 用 尸 能 够 以 最 快 的 方 
式 目 动 获 得 最 合适 的 内 容 和 布局 。 事 实 上 ， 使 用 服务 套 端 检测 时 ， 不 会 下 载 用 不 到 
的 数据 ， 也 不 会 肥 出 额外 的 请 求 来 获取 专门 的 视图 。 服 务 费 闹 检 测 的 问题 在 于 网 站 
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的 维护 ， 以 及 配置 参数 和 分 部 视图 的 激增 。 
如 果 对 于 公司 业务 来 说 ， 提 供 不 同 的 体验 全 关 重 要 ， 那 么 创建 一 个 专门 的 移动 
网 站 仍然 古 可 以 考虑 的 有 效 选 项 。 


2. 重 定 向 到 移动 网 站 


假设 现在 有 两 个 网 站 : 完整 网 站 (可 能 是 啊 应 式 的 ， 也 可 能 不 是 ) 和 移动 网 站 (有 
时 称 为 msite)。 如 何 访问 它们 呢 ? 在 现实 应 用 中 ， 有 许多 方式 处 理 这 个 问题 ， 并 且 
者 得 到 了 民 好 的 业务 结 采 。 

我 相信 我 们 都 同意 ， 让 网 站 只 有 一 个 公开 的 URL 是 很 好 的 做 法 。 用 户 只 需要 记 
住 www 部 分 ， 软 件 则 悄悄 切换 到 最 合适 的 内 容 。 我 们 可 能 都 同 总， 不 这 么 做 的 公 
司 可 能 会 遇 到 一 些 业 务 痛 点 。 可 以 考虑 执行 一 些 非 划 基本 的 、 简 单 的 设备 检测 ， 根 
据 检 测 结果 和 昔 定 问 到 为 外 一 个 使 用 了 不 同 URL 的 网 站 。 在 这 种 情况 下 ， 并 不 是 必 
须知 道 设 备 的 所 有 细节 ， 而 只 需要 大 致知 道 议 备 是 个 是 移动 议 备 。 

从 开 友 的 角度 看 ， 可 以 将 专门 的 移动 网 站 视 为 不 同 的 项 目 。 将 其 作为 一 个 不 同 的 
项 目 是 一 个 很 大 的 成 束 ， 因 为 可 以 采用 专门 的 搁 术 和 框 染 开 发 这 个 项 目 ， 将 其 外 包 给 
其 他 公司 ， 让 不 同 的 人 员 开 发 ， 以 及 推 后 开发 。 男 外 ， 可 以 在 任何 时 候 洪 加 移动 网 站 。 


13.4 ” ”小结 


服务 器 端 解决 方案 在 本 质 上 比 完全 客户 端的 、 基于 RWD 的 解决 方案 更 加 灵活 ， 
因为 服务 器 端 解决 方案 允许 在 发 送 内 容 之 前 先 检查 设备 。 通 过 这 种 方式 ， 网 站 可 以 
智能 地 确定 最 合适 的 内 容 。 但 是 ， 在 实际 应 用 中 ， 提 供 设备 专用 的 视图 从 来 不 是 简 
单 的 工作 ， 关 键 的 问题 不 在 于 用 来 检测 设备 的 机 制 ， 而 在 于 成 本 。 

设备 检测 并 不 意味 着 为 每 个 浏览 器 或 设备 提供 不 同 版 本 的 页 面 。 从 现实 应 用 的 
角度 来 看 ， 它 意味 着 为 最 常见 的 外 形 规格 一 一 桌面 设备 、 智 能 手机 、 平 板 电脑 、 遗 
留 手机 、 可 能 还 包括 极 大 屏幕 的 设备 一 一 维护 至 多 3 套 或 4 套 视图 。 无 疑 ， 维 护 多 
个 页 面 会 增加 成 本 。 

如 今 ， 听 起 来 最 合适 的 方法 是 创建 一 个 默认 的 响应 式 解 决 方案 ， 再 另外 创建 一 
个 单独 的 、 针 对 智能 手机 的 网 站 ， 并 让 这 个 网 站 只 处 理 对 移动 用 户 有 意义 的 用 例 。 
通过 部 署 两 个 独立 的 网 站 ， 然 后 使 用 客户 端 检 测 进行 重 定向 ， 可 以 实现 这 一 方案 。 
另外 一 种 方法 是 使 用 服务 器 端 方法 ， 可 以 更 好 地 控制 行为 ， 并 且 当 决 定 对 更 多 外 形 
规格 开放 网 站 时 ， 能 够 更 加 轻松 、 更 加 灵活 地 扩展 网 站 

无 论 采 用 哪 种 方法 ， 作 为 开发 人 员 ， 都 不 能 忽略 移动 设备 上 的 用 户 体验 ， 其 至 
不 能 认为 只 需要 使 用 响应 式 模板 就 能 应 对 各 种 情况 。 响 应 式 模板 仅仅 是 一 个 答案 ， 
其 至 不 是 完全 正确 的 答案 。 
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现在 你 已 经 准备 好 ， 能 够 使 用 ASP.NET Core 构建 现代 解决 方案 了 。 但 
是 ,在 结束 本 书 之 前 ， 还 应 当 拓宽 对 开 友 生命 周期 的 认识 。 这 一 部 分 探讨 一 
些 天 键 的 问题 ， 涉 及 ASPNET Core 的 运行 时 管道 、 应 用 程序 部 署 以 及 从 日 
版 本 的 ASPNET 框架 迁移 。 

第 14 章 进 一 步 深 入 地 分 析 ASPNET Core 运行 时 环境 的 内 部 架构 、 其 
Kestrel 服务 器 及 核心 中 间 件 。 这 些 新 技术 从 根本 上 建立 了 一 个 与 Web 服务 
做 环境 完全 解 帮 的 路 平台 运行 时 。 

第 15 草 介 绍 了 ASPNET Core 多 样 的 应 用 程序 部 办 选 项 : 不仅 可 以 部 署 
到 Windows Server 或 Microsoft Azure 应 用 服务 ,还 可 以 部 车 到 Linux 本 地 机 
骨 、 第 二 方 云 环 境 ( 如 Amazon Web Services，AWS) 及 Docker 容 占 。 

最 后 , 第 16 章 分 析 了 迁移 到 ASPNET Core 时 面临 的 权衡 问题 。 该 章 将 
分 析 在 greenfield 开发 、brownfield 开发 以 及 在 两 种 场景 之 间 开 发 项 目 时 ， 
ASPNET Core 的 价值 。 还 将 介绍 一 些 非常 实用 的 工具 和 技术 ， 来 规划 迁移 ， 
包括 问 微服 务 和 容器 迁移 的 机 会 。 


第 4 过 


。 AsP.NET Core 的 运行 时 环境 


重重 的 顾虑 使 我 们 全 变 成 了 惨 夫 ， 决 心 的 赤 热 的 光彩 ， 被 审慎 的 思维 盖 上 了 一 
层 灰 色 。 


一 一 威廉 " 沙 士 比 亚 , 《哈姆雷特 》 


在 第 2 草 ， 揭 开 了 ASPNET Core 这 合 机 堪 的 盖子 ， 看 了 一 眼 其 内 部 结构 。 在 
这 个 过 程 中 我 们 了 解 到 ，ASPNET Core 的 运行 时 环境 以 及 请 求 经 过 的 管道 与 
ASPNET 以 前 的 版 本 有 着 明显 的 区 别 。 另 外 ， 新 的 ASPNET Core 运行 时 环境 还 增 
加 了 一 个 系统 提供 的 、 内 置 的 依赖 注入 (DD 基础 结构 ， 它 静 静 地 监视 着 处 理 传 入 请 

本 章 将 在 第 2 章 的 基础 上 更 进一步 ， 深 入 探讨 ASPNET Core 运行 时 环境 的 内 
部 架构 以 及 组 件 ， 主 要 是 Kestrel 服务 器 和 请 求 中 间 件 。 


14.1 ASP.NET Core 的 宿主 


ASPNET Core 应 用 程序 本 质 上 是 一 个 独立 的 控制 台 应 用 程序 , 它 为 实际 的 应 用 
程序 模型 (最 有 可 能 是 MVC 应 用 程序 模型 ) 设 置 特 主 环境 。 生 主 负 贡 配 置 一 个 服务 器 ， 
该 服务 器 监听 传 入 的 HITP 请 求 ， 并 将 其 传递 给 处 理 管 道 。 下 面 的 代码 展 示 了 一 个 
典型 ASPNET Core 应 用 程序 的 宿主 程序 的 默认 实现 , 这 里 的 ASPNET Core 应 用 程 
序 是 使 用 Visual Studio 2017 的 标准 模板 创建 的 下面 的 源 代 但 包含 在 ASPNET Core 
项 目的 Program.cs 文件 中 。 

public class Program 


{ 


Public static void Main(string[l|] args) 


316 


第 V 部 分 ASPNET Core 生态 系统 


1 
BuildWebHost (args) .Run (); 
} 


public static IWebHost BuildwWwebHost (string[|] args) 三 > 
WebHost.CreateDefaultBuilder (args) 
.UseStartup<Sstartup> () 
.Bulild(); 
} 


接 下 来 详细 介绍 Web 宿主 组 件 ， 以 及 其 他 可 以 用 来 启动 宿主 的 更 简单 的 选项 。 
14.1.1 WebHost 类 


WebHost 是 一 个 静态 类 ， 它 提供 了 两 个 方法 ， 用 来 创建 会 开 ITWebHostBuilder 
接口 的 类 的 实例 ， 并 在 实例 中 添加 预定 义 设 置 。 该 关 还 提供 了 许多 方法 ， 可 通过 传 
递 要 监听 的 URL 和 所 要 实现 的 行为 的 委托 ， 快 速 局 动 环 境 。 这 证 明 ASPNET Core 
运行 时 极其 灵活 ， 下 面 的 示例 将 清晰 说 明 这 一 点 。 


1. 配置 神主 的 行为 


WebHost = 六 的 Start 方法 允许 以 多 种 方式 设置 应 用 程序 。 其 中 最 值得 注意 的 是 重 
载 ， 它 用 一 个 普通 的 Lambda 函数 来 设置 应 用 程序 。 
USinNng (var host = WebDbDHost .Start 
app => app.Response.WriteAsync("Programming ASP.NET Core™))) 


{ 
// Wait for the host to end 


} 


不 管 调用 的 URL 是 什么 , 应 用 程序 所 做 的 就 是 运行 指定 的 函数 。 WebHost 类 的 
Start 方法 返回 的 实例 是 TWebHost 类 型 ， 代 表 已 经 为 应 用 程序 局 动 的 宿主 环境 。 在 
WebHost.Start 方法 内 会 运行 下 面 的 伪 代 码 : 

public static IWebHost Start (RequestDelegate app) 

{ 

Var defaultBuilder = WebHost.CreateDefaultBuilder () ， 
Var host = defaultBuilder.Build();} 


// This line actually starts the host 
host.Start(); 
return host,; 


| 
注意 ，Start 方法 以 非 阻 塞 的 方式 运行 笨 主 ， 这 意味 着 箱 主 需要 额外 的 指令 来 继 
续 监 听 传 入 的 请 求 。 示 例如 下 (参见 图 14-1)。 


public static Vvoid Main(string[|] args) 
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usSing (var host = WebHost.start( 
app => app.Response.WriteAsync ("Programming ASP.NET Core™))) 


{ 
// Wait for the host to end 
Console.WriteLine ("Courtesy of 'Programming ASP.NET Core' \n====")} 


Console.WriteLine("Use Ctrl-c to shut down the host..."); 
host .WaitForShutdown (}); 


esy of "Programmine ASP.NET Core’ 


Use Ctrl=C to Shutdewn 七 he host... 
Microsoft .ispNetCore.Hosting.Internal .WebHost|[1] 
Request starting HTTP/1.1 GET http://localhost:68749/ 
"licrosoft .AspNetcCore.Hosting.Internal .WebHost[21] 


Request finished in 493.3861ims 288 
Microsoft .AspNetcCore.Hosting.Internal .WebHost[1] 
yA 


Request starting HTTR/1.1 GET http:,//localhost:68749 


Microsoft .AspNetCore.Hosting.Internal .WebHost[2] 
9.6233ms 266 


Raequast finished in 9., 


症 二 | 电 localhost 
所 一 [加 ) 人 localhost: 


Programming ASP.NET Core 


六 | 太太 


图 14-1 宿主 的 应 用 


默认 情况 下 ， 箱 主 在 端口 5000 监听 传 入 的 请 求 。 在 图 14-1 中 可 以 看 出 ， 即 使 
用 尸 级别 代 人 码 没 有 明确 局 动 记 录 帮 ， 记 录 咒 也 会 目 动 局 动 。 这 意味 看 笨 主 收 到 了 一 
些 默 认 配置 。Start 方法 会 在 内 部 调用 WebHost.CreateDefaultBuilder 方法 ， 后 者 负责 
接受 默认 设置 。 下 向 详细 介绍 默认 设置 。 


2. 默认 充 置 

在 ASPNET Core 2.0 中 , CreateDefaultBuilder 方法 (定义 为 WebHost 类 的 
态 方法 ) 创 建 并 返回 牡 主 对 象 的 一 个 实例 。WebHost 上 定义 的 所 有 Start 方法 最 终 都 
会 在 内 部 调用 默认 生成 费 。 下面 的 代码 演示 了 调用 默认 的 Web 答 主 生成 费时 会 发 生 
什 A 9 


public static IWebHostBuilder CreateDefaultBuilder(stringl[l|] args) 


个 前 


{ 


return new WebHostBuilder() 


.UseKestrell() 
-UseContentRoot (Dijrectory.GetCurrentDirectory()) 


-ConfijqureAppConfjguration'l 
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(Action<WebHostBuilderContext, IConfigurationBuilder>) 
( (context, config) => 
{ 
Var env = context.HostingEnvironment; 
config.AddJsonFile ("appsettings.Json"y true, true) 
.AddJsonFile(string.Format ("appsettings.{0}.Json", 
enVv .EnvironmentName), true, true),; 
if (env.IsDevelopment()})) 
{ 
Var assembly = Assembly.Load (new AssemblyName (env - 
ApplicationName) )，; 
if (assembly != null) 
config.AddUserSecrets (assembly, true}); 

} 

config.AddEnvironmentVariables()}); 

config.AddCommandLine (args);} 

} )) 
.ConfigureLoggingl 
(Action<WebHostBuilderContext, ILoggingBuilder>) ((context, 
loogging) 三 > 


logging.AddConfigqguration (context .Configquration. 
GetSection ("Logging™)); 
logging.AddConsole ();}; 
logging.AddDebug () ， 
})) 


-UseIlIlSIntegration () 
.UseDefaultServiceProvider( 
(Action<WebHostBuilderContext, ServiceProvideroptions>) ((context, 
options) => 
{ 
options.ValidateScopes = context.HostingEnvironment. 
IsDevelopment (})));}; 
} 
一 言 以 英之 ， 扶 认 生成 费 做 了 6 项 工作 ， 如 表 14-1 所 述 。 
表 14-1 默认 生成 器 执行 的 操作 
动作 描述 

Web 服务 器 添加 Kestrel 作为 ASPNET Core 管道 中 的 艇 入 式 Web 服务 器 

内 容 根 文件 夹 将 当前 目录 设置 为 Web 应 用 程序 访问 的 任何 基于 文件 的 内 容 
的 根 文件 夹 

配 直 添加 一 些 配 置 提 供 程序 : appsettings.json、 环 境 变 量 、 命令 行 参 
数 和 用 户 密码 (只 用 在 开发 模式 中 ) 

记录 日 忘 添加 一 些 日 忘 提供 程序 ， 配置 树 的 日 记 记 录 厂 中 定义 的 日 记 扣 
供 程 序 ， 以 及 控制 人 台 和 调试 记录 疾 

IIS 启用 IS 作为 反 向 代理 

服务 提供 程序 配置 默认 的 服务 提供 程序 


需要 特别 注意 的 是 ， 每 当 调 用 WebHost 关 的 东 个 方法 来 月 动 Web 应 用 程序 的 
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答 主 时 , 所 有 这 些 操 作者 不 在 你 的 控制 之 下 。 如 条 想 为 征 主 应 用 目 定 义 的 一 组 设置 ， 
请 继续 疯 谈 。 但 是 ， 在 介绍 目 定 义 牡 主 配 章 之 前 ， 先 来 看 看 可 以 使 用 哪些 选项 来 实 
际 运行 箱 主 ， 并 使 其 监听 传 入 的 调用 。 


提示 : 

为 了 在 Visual Studio 中 查看 类 的 源 代码 ， 我 使 用 ReSharper。 按 下 F12 键 后 ， 
ReSharper 包含 的 dotPeek 能 够 执行 实际 的 反 编 译 工作 。 如 果 不 使 用 ReSharper， 仍 
然 可 以 在 Visual Studio 中 配置 dotPeek 它 是 一 个 免费 的 工具 一 一 来 作为 符号 服务 
器 。 更 多 信息 请 访问 http://bit.ly/2AnTOvK。ILSpy 是 市 场 上 另外 一 个 可 以 在 Visual 
Studio 中 免费 使 用 的 反 编 译 器 。 


3. 启动 答 主 

每 当 通 过 WebHost 类 公开 的 方法 创建 宿主 时 ， 会 收 到 一 个 已 经 启动 的 和 宿主， 它 
已 经 在 监听 配置 的 地 址 。 如 前 所 述 , 默认 使 用 的 Start 方法 以 非 阻 唉 的 方式 局 动 答 主 ， 
但 也 有 其 他 选项 。 

Run 方法 启动 Web 应 用 程序 , 然后 阻 窟 调用 线程 ， 直人 到 关闭 答 主 。WaitForShutDown 
阻塞 调用 线程 ， 直 到 手动 (如 通过 Ctrl + C) 触 发 应 用 程序 的 关闭 操作 。 


14.1.2 目 定 义 答 主 设置 


的 认 的 牡 主 生成 堆 使 用 起 来 很 向 单 ,并且 创建 的 牡 主 具备 所 需要 的 大 部 分 功能 。 
可 以 添加 一 坚 额外 的 方面 来 进一步 扩展 循 主 ， 如 局 动 突 和 要 监听 的 URL。 也 可 以 让 
和 宿主 的 功能 比 默认 宿主 少 。 


1. 手动 创建 Web 宿主 
下 面 的 代码 显示 了 如 何 从 头 创 建 一 个 全 新 的 御 主 。 


Var host = new WebHostBUuUllader() .Build().; 


WebHostBuilder 类 有 许多 扩展 方法 可 用 来 添加 功能 。 全 少 ， 需 要 指定 要 使 用 的 
进程 内 HITP 服务 器 实 现 。 此 Web 服务 器 监听 HTTP 请 求 ， 并 把 它们 包装 到 友好 的 
HttpContext 包 中 来 转发 给 应 用 程序 。Kestrel 是 默认 的 ， 也 是 最 利用 的 Web 服务 需 
实现 。 要 局 用 Kestrel， 需 要 调用 UseKestrel 方法 。 

为 了 使 自己 的 Web 应 用 程序 与 IS 宿主 兼容 ， 还 需要 使 用 UseIISIntegration 扩 
展 方法 来 司 用 该 功能 。 最 后 ， 可 能 还 需要 指定 内 容 根 文件 夹 和 要 使 用 的 司 动 类 ， 以 
了 最终 完成 对 运行 时 环境 的 配置 。 


Var host = new WebHostBEBuilLadeTr () 
.UseKestrel() 


319 


320 


第 V 部 分 ASPNET Core 生态 系统 


.UselIlISIntegration() 
-UseContentRoot (Directory.GetCurrentDirectory()) 
Build(}); 


在 这 里 ， 还 必须 指定 应 用 程序 的 另 两 个 方面 。 其 一 是 应 用 程序 设置 的 加 载 ， 其 二 
是 终止 中 间 件 。 在 ASPNET Core 2.0 中 , 可 以 使 用 新 的 ConfigureAppConfiguration 方法 
来 加 载 应 用 程序 设置 ， 如 上 面 的 代码 段 所 示 。 也 可 以 使 用 Configure 方法 来 添加 终 
止 中 间 件 ， 即 能 够 处 理 任 何 传 入 请 求 的 代码 。 


Var host = new WebHostBuilder() 
.UseKestrel() 
-UsellISIntegration() 
-UseContentRoot (Directory.GetCurrentDirectory()})) 
.Confijgure(app => | 
app.Run (async (context) => | 
Var path = context .RedGuest .Path ; 
awalit context.Response.WriteAsync("<hl>"™" + path + 
</hl>"):; 
}); 
}) 
- Bulld(); 


男 外 ， 还 可 以 在 局 动 类 中 更 加 方便 地 指定 应 用 程序 设 苟 、 终 止 中 间 件 和 各 种 可 
选 的 中 间 件 组 件 。 启动 类 只 是 通过 UseStartup 方法 传递 给 Web 宿主 生成 器 实例 的 另 
一 个 相关 参数 。 

Var host = new WebHostBulilder () 

.UseKestrel () 
.UseIIlISIntegration() 
.UseContentRoot (Directory.GetCurrentDirectory()) 
. Usestartup<startup> () 
.Build({(); 
从 功能 上 讲 ， 上 面 的 代码 片段 交付 了 许多 功能 ， 足 够 运行 ASPNET Core 2.0 应 


可 通过 多 种 方式 指定 局 动 尖 ， 最 沿用 的 方式 古 使 用 泛 型 版 本 的 UseStartup<T> 
扩展 方法 ， 其 中 类 型 标识 了 局 动 类 。 上 和 面 的 代 人 码 段 演示 了 这 种 方法 。 
另外 ， 也 可 以 使 用 非 泛 型 格式 的 UseStartup 方法 ， 并 传 入 .NET 类 型 引用 作为 


Var host = new WebpHostEBU1ITLaeTr () 
.USEKeStrel () 
.UseIISIntegration() 
.UseContentRoot (Directory.GetCurrentDirectory!()) 
.Usestartup (typeof (MyStartup)) 
. Build(); 
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Var host = new WebHostBRuilder() 
.UseKestrell() 
.UsellSIntegration() 
.UseContentRoot (Directory.GetCurrentDirectory!()})) 
-USeStartup (Assembly.Load (new AssemblyName ("Chl4.Builder")). 
FuUllName) 
-BUILT 
如 果 选 择 向 UseStartup 传递 一 个 程序 集 名 称 ， 那 么 将 认为 程序 集中 包含 一 个 名 
为 Startup 或 StartupXxx 的 类 ， 其 中 Xx 与 当前 的 特 主 环境 (Development、Production 
等 ) 相 兄 配 。 


3. 应 用 程序 的 生存 期 


在 ASPNET Core 2.0 中 , 有 3 个 应 用 程序 生存 期 事件 可 供 开 肥 人 员 用 来 执行 司 
动 或 天 闭 任务 。IApplicationLifetime 接口 定义 了 可 以 在 代码 中 挂钩 的 宿主 事件 。 
public interface IApplicationLifetime 
{ 
CancellationToken Applicationstarted { gqet; |} 
CancellationToken ApplicationSstopping 1{ get; 上 } 
CancellationToken ApplicationSstopped 1{ get; |} 
VOid StopApplication(); 
} 
可 以 看 到 ， 除 了 started、stopping 和 stopped 事件 之 外 ， 访 接口 还 有 一 个 主动 的 
StopApplication 方法 。 在 启动 类 的 Configure 方法 中 可 添加 事件 处 理 代码 。 
Public void Configure (IApplicationBuilder app, IApplicationLifetime life) 
{ 
// Configures a graceful shutdown of the application 
life.Applicationstarted.Register (OnSstarted); 


Jife.Applicationstopping.Reglster (OnStopping),; 
lJ]ife.Applicationstopped.Register (OnSstopped); 


/ More runtime configuration here 

1 

当 答 主 已 经 局 动 并 运行 ,并且 在 等 竺 被 代 公 关闭 的 时 候 ， 代 人 码 会 收 到 
ApplicationStarted 事件 。ApplicationStopping 事件 指出 代码 已 经 开始 关闭 应 用 程序 ， 
但 是 队列 中 可 能 还 有 一 些 请 求 。 和 突 主 实质 上 即将 关闭 。 最 后 ， 当 队列 中 再 没有 了 生 
处 理 的 请 求 时 ,将 触发 ApplicationStopped 和 事件。 一旦 终 上 对 事件 的 人 处理, 就 将 关闭 
宿主 。 

StopApplication 方法 是 接口 方法 ， 可 在 代码 中 局 动 关闭 Web 应 用 程序 窒 主 的 操 
作 。 如 果 在 dotnet.exe 启动 占 控 制 台 窗口 中 按 CtrlLHC 组 合 键 ， 也 将 在 后 妆 调 用 此 方 
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法 。 如 果 使 用 下 面 的 代码 ， 那 么 期 望 的 输出 如 图 14-2 所 示 。 


"| Select CN\Program Files\dotnet\dotnet.exe 


Content root path: D:\My Demos\Core\TheBook\Programming ASP.NET Core\srce\Ch14\Builder 
Now listening en: http://localhost:7888 

bpplication started. Press Ctrli+c te shut deown. 

Mpplication is shutting down... 


图 14-2 ”应 用 程序 生存 期 事件 


private static Vvoid Onstarted () 


{ 
/ Perform post-startup activities here 
Console.WriteLine ("Started\n====="}); 
Console.BackgroundColor = ConsoleColor.Blue; 
} 


private static Volad Onstopping() 


{ 
// Perform con-stopping activities here 
Console.BackgroundColor = ConsoleColor.Black; 
Console.WriteLine("—————\nSstopping\n————\n"™); 

} 

private static Vola Onstopped() 

{ 
// Perform post-stopped activities here 
Var defaultForeColor = Console.ForegroundColor; 
Console.ForegroundColor = ConsoleColor.Red,; 
Console.WriteLine(" stopped.™); 
Console.ForegroundColor = defaultForeColor; 
Console.WriteLine(" Press any key. }):; 
Console.ReadLine ();，; 

} 


可 以 看 到 ， 生 存 期 事件 包装 了 Web 应 用 程序 的 所 有 活动 。 
4. 其 他 设置 


通过 使 用 一 组 额外 设置 ， 细 微调 整 Web 宿主 行为 ， 可 进一步 定制 Web 宿主 。 
表 14-2 列 出 了 所 有 这 些 额 外 设置 。 
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表 14-2 Web 宿主 的 额外 设置 
扩展 方法 摘 述 
CaptureStartupErrors | 控制 是 耕 捕 捉 启动 错误 的 布尔 值 。 默 认 值 为 false， 除 非 整 体 配置 设 
置 了 在 IS 的 后 面 运行 Kestrel。 如 果 不 捕 捉 错误 ， 则 任何 异常 都 将 导 
致 宿主 退出 。 如 果 捕 捉 错误 ,将 吞 下 启动 异常 ， 但 是 宿主 仍 尝试 启动 
配置 的 Web 服务 器 
UseEnvironment 在 代码 中 设置 应 用 程序 的 运行 环境 ,该 方法 接受 一 个 字 从 串 作 为 参数 
匹配 预定 义 的 环境 ， 如 Development、Production、Staging 或 其 他 任 
何 对 应 用 程序 而 言 有 意义 的 环境 。 正 常情 况 下 , 环境 名 称 是 从 环境 变 
量 (ASPNETCORE ENVIRONMENT) 读 取 的 ， 使 用 Visual Studio 时 ， 
可 通过 用 户 界面 或 者 在 launchSettings.json 文件 中 设置 环境 变量 
UseSetting 这 是 一 个 通用 的 方法 , 用 于 通过 关联 的 键 百 接 设置 选项 。 使 用 此 方法 
设置 值 的 时 候 ， 无 论 值 是 什么 类 型 ， 都 会 把 值 设置 为 一 个 字符 串 ( 包 
含 在 引号 内 )。 此 方法 可 用 来 配置 以 下 设置 : 


DetailedErrorsKey 布尔 仁 ， 指 定 是 否 应 该 捕捉 和 报告 
错误 的 详情 。 默 认 值 为 false 


HostingStartupAssembliesKey | 用 分 号 分 隔 的 字符 串 ， 指 定 了 要 启 
动 时 加 载 的 额外 程序 集 的 名 称 。 默 
认 值 为 空 字符 串 


PreventHostingStartupKey 阻止 目 动 加 和 载 司 动 程 序 集 ， 包 括 应 
用 程序 的 程序 集 。 默 认 值 为 false 
ShutdownTimeoutKey 指定 Web 宿主 在 等 待 和 多 少 秒 后 关 


闭 。 默 认 值 为 5s。 注 意 ， 使 用 
UseShutdownTimeout 扩展 方法 可 以 
实现 相同 的 设置 。 等 待 时 间 让 Web 
特 主 有 时 间 来 完整 处 理 请 求 
属性 名 称 表 达 为 WebHostDefaults 榴 闪 的 属性 。 


WebHost .CreateDefaultBuilder (args) 


.UseSetting (WebHostDefaults.DetailedErrorsKey, “true™); 
UseShutdownTimeout | 指定 Web 宿主 在 等 待 多 少 秒 后 关闭 。 默 认 值 为 5s。 此 方法 接受 一 个 
TimeSpan 值 


你 可 能 会 奇怪 ,为 什么 会 对 Web 宿主 的 配置 进行 这 样 极为 细致 的 控制 ; 以 及 为 
什么 远 在 应 用 程序 实际 启动 之 前 ， 就 能 够 在 Web 宿主 级 别 ， 在 program.cs 中 配置 应 
用 程序 的 设置 。 问 题 的 答案 包括 两 个 方面 : 首先 是 完整 性 ， 其 次 是 能 够 方便 集成 测 
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试 。 使 Web 答 主 的 设 息 极为 灵活 ， 环 方便 了 开发 人 员 创 建 副本 项 目 ， 其 中 除了 答 主 
以 外 ， 其 他 设置 完全 相同 ， 而 且 可 以 调整 宿主 的 配置 ， 以 匹配 指定 的 集成 场景 。 

本 节 有 意 跳 过 了 另外 一 个 配置 参数 : Web 服务 器 监听 传 入 请 求 的 URL 列表 。 
这 个 参数 将 在 14.2 节 介 绍 ， 到 时 会 专门 讨论 ASPNET Core 内 置 的 Web 服务 器 的 选 
择 和 配置 。 


注意 ; 

在 表示 Web 宿主 的 配置 时 ,设置 的 顺序 很 重要 , 但 是 总 体 上 遵守 一 个 基本 的 规 
则 : 最 后 指定 的 设置 是 要 应 用 的 设置 。 因此， 如 果 指 定 了 多 个 启动 类 ， 那 么 不 会 抛 
出 错误 ， 但 是 最 后 指定 的 设置 将 优先 采用 . 


14.2 内置 的 HTTP 服务 器 


ASPNET Core 应 用 程序 需要 一 个 进程 内 的 HITP 服务 器 才能 运行 。Web 笨 主 局 
动 这 个 HITP 服务 器 ， 并 使 其 监听 配置 的 痛 口 和 URL。HTTP 服务 器 应 当 捕 捉 传 入 
的 请 求 ， 并 将 请 求 转 发 给 ASPNET Core 管道 , 让 配置 的 中 间 件 来 处 理 请 求 。 图 14-3 
所 示 为 整体 架构 。 


ASPNET Core 2.0 


图 14-3 ” ASPNET Core 运行 时 架构 中 的 HTTP 服务 器 


内 部 HTTP 服 务 器 


在 图 14-3 中 ，ASPNET Core 内 部 的 HTTP 服务 器 直接 连接 到 Internet 空间 。 在 
实际 应 用 中 ， 这 种 直接 连接 是 可 选 的 配置 。 事 实 上， 可 以 选择 在 二 者 之 间 加 入 一 个 
反 回 代理 ， 防 止 开 放 的 Internet 直接 访问 内 部 HITP 服务 器 。 


14.2.1 选择 HTTP 服务 器 


图 14-3 所 示 的 内 部 HITP 服务 器 可 以 基于 Kestrel, 也 可 以 基于 内 核 级 驱动 程序 
http.sys。 无 论 是 哪 种 情况 ，HTT?P 服务 器 的 实现 都 将 监听 配置 的 一 组 端口 和 URL， 
并 将 任何 传 入 的 请 求 分 发 给 ASPNET Core 2.0 管道 。 


1. Kestrel 与 Http.sys 的 对 比 


对 于 ASPNET Core 2.0，Kestrel 是 最 常用 的 内 部 HTTP 服务 器 。 这 是 一 个 基于 
libuv 的 跨 平 台 Web 服务 器 ， 而 libuv 是 一 个 跨 平 台 的 异步 VO 库 。 在 Visual Studio 
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中 创建 新 的 ASPNET Core 项 目 时 ， 模 板 生 成 的 代码 使 用 Kestrel 作为 Web 服务 器。 
关于 Kestrel， 最 值得 注意 的 一 点 是 ，.NET Core 文 持 的 所 有 平台 和 版 本 ， 都 文 持 
Kestrel。 

除了 使 用 Kestrel， 还 可 以 使 用 http.sys。http.sys 是 只 有 Windows 文 持 的 HTTP 
服务 器 ， 依 赖 于 忠实 的 Windows http.sys 内 核 驱 动 程序 的 服务 。 一 般 来 说 ， 除 了 少 
数 特定 的 场景 以 外 ， 部 应 该 使 用 Kestrel。 在 ASPNET Core 2.0 版 本 发 布 之 前 ， 对 于 
不 需要 使 用 反问 代理 来 防止 公共 Internet 访问 应 用 程序 的 场景 ,不 建议 使 用 Kestrel。 
在 这 方面 ，http.sys 更 可 靠 ( 尽 管 只 能 在 Windows 平台 上 使 用 )， 因 为 它 是 以 更 成 熟 的 
技术 为 基础 。 另 外 ，http.sys 是 专门 针对 Windows 的 ， 所 以 按照 设计 ， 其 文 持 的 一 
些 功 能 是 Kestrel 所 不 文 持 的 ， 如 Windows 身份 验证 。 

为 了 进一步 强调 http.sys 的 健壮 性 ， 应 该 想到 IIS 就 是 在 http.sys 之 上 工作 的 
HTTP 监听 器 。 但 是 ， 未 来 的 路 已 经 铺 好 。Kestrel 是 跨 平 台 的 ， 将 作为 一 个 健壮 的 
Web 服务 器 不 断 改进 ， 能 够 在 没有 反问 代 理 的 情况 下 开放 Internet 的 访问 。 我 的 建 
议 是 使 用 Kestrel， 除 非 Kestrel 不 适合 目 己 的 项 目 。 下 面 的 代码 显示 了 在 ASPNET 
Core 应 用 程序 中 如 何 司 用 http.sys。 


Var host = new WebHostBuilder() -UseHLtPSYS () .Build(); 
不 适合 使 用 Kestrel 时 ， 在 Windows 之 外 的 平台 上 可 以 使 用 反 回 代理 (如 Nginx 
或 Apache)。 在 Windows 上 ， 可 以 选择 直接 使 用 http.sys 或 使 用 IIS 。 


注意 : 
目 关于 使 用 http.sys 所 需要 做 的 额外 配置 的 更 多 信息 ,请 访问 https://docs.microsoft 
.com/en-us/aspnet/core/fundamentals/servers/httpsys. 
2. 指定 URL 
可 以 配置 内 部 HTTP 服务 占 ， 使 其 监听 多 个 URL 和 端口 。 通 过 Web 答 主 生成 
峰 类 型 上 定义 的 UseUrls 扩展 方法 来 指定 这 些 信息 。 
Var host = new WebHostBulilder () 
.UseFRKestrell() 
.UseUrls("”...") 
.Build() ; 
UseUrls 方法 指明 了 香 主 的 地 址 ， 以 及 服务 顺应 该 在 哪些 关口 和 协议 上 监听 传 
入 的 请 求 。 如 果 需 要 指定 多 个 URL， 则 需要 用 分 号 分 隔 。 默 认 情况 下 ， 内 部 Web 
服务 絮 监 听 本 地 主机 的 端口 5000。 使 用 * 通 配 竺 ， 可 使 服务 规 监 听任 何 主机 名 上 使 
用 了 指定 端口 和 协议 的 请 求 。 例 如 ， 下 面 的 代码 也 是 可 以 接受 的 。 


Var host = new WebHostBuilder() 
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.UseKestrel () 
.UseUrls{"http://*:7000") 


.BUlil1d(); 


注意 ，ASPNET Core 的 内 部 HTTP 服务 器 的 特征 是 由 IServer 接口 实现 的 。 这 
意味 着 除了 Kestrel 和 http.sys, 甚至 可 以 通过 实现 该 接口 来 创建 自己 的 自 定义 HTTP 
服务 器 。IServer 接口 提供 了 一 些 成 员 ， 可 用 来 配置 服务 器 应 该 在 什么 端口 上 监听 请 
求 。 默 认 情 况 下 ， 要 监听 的 URL 列表 来 自 Web 牡 主 。 但 是 ， 可 以 通过 服务 器 目 己 
的 API, 强制 服务 器 接受 URL 列表 。 这 可 以 使 用 Web 牡 主 的 PreferHostingUrls 扩展 
方法 实现 。 

var host = new WebHostBuilder () 


.UseKestrell() 
-PreferHostingUrls (false) 


re 
3. hosting.json 文件 


使 用 UseUrls 方法 ， 甚 至 为 问 点 使 用 服务 如 的 指定 API， 也 有 一 个 缺点 : URL 
的 名 称 被 便 编 码 到 应 用 程序 的 源 代码 中 ， 要 想 修改 ， 就 必须 午 新 编译 。 为 了 避 倪 这 
种 情况 ， 可 以 从 外 部 文件 (hosting.json 文件 ) 加 载 HTTP 服务 器 配置 。 

这 个 文件 必须 在 应 用 程序 的 根 文件 夹 中 创建 。 下 面 的 例子 显示 了 如 何 设 置 服务 
石 的 URL。 


{ 
"SeTrVer.Ur1s": "http://localhost:7000;http://localhost:7001"™ 


} 


要 强制 加 载 hosting.json 文件 ， 需 要 先 调用 AddJsonFile 将 其 添加 到 应 用 程序 的 
设置 中 。 


14.2.2 配置 反 向 代理 


最 初 ， 没 有 将 Kestrel 服务 器 设计 为 问 Internet 开放 ， 这 意味 看 出 于 安全 考虑 ， 
以 及 防止 应 用 程序 遭受 潜在 的 Web 攻击 ， 需 要 在 Kestrel 上 方 使 用 反 向 代理 。 但 是 ， 
从 ASPNET Core 2.0 开始 ， 加 入 了 更 坚固 的 防御 ， 因 此 需要 考虑 更 多 配置 选项 。 


注意 : 

除了 安全 原因 ， 还 有 一 种 场景 需要 使 用 反 向 代理 : 在 同一 个 服务 器 上 运行 着 多 
个 应 用 程序 , 它们 共享 相同 的 JP 和 端口 .Kestrel 并 不 支持 这 种 场景 ; 一 旦 配置 了 Kestrel 
使 其 监听 某 个 端口 后 ，Kestrel 会 处 理 传 入 该 端口 的 所 有 流量 ， 并 不 考虑 宿主 头 。 
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1. 使 用 反问 代理 的 原因 

不 管 将 Kestrel 背后 的 应 用 程序 设计 为 问 公 共 Intemet 开放 ， 还 是 仅 回 内 部 网 络 
开放 ， 部 可 以 将 HITP 服务 八 配 置 为 使 用 或 不 使 用 反 巾 代理。 简单 来 次 ， 反 加 代理 
是 一 个 代理 服务 堆 ， 代 表 客 尸 靖 从 一 个 或 多 个 服务 堆 检 索 资 源 (如 图 14-4 所 示 )。 
浏览 器 ”| RE RE 


实际 的 Web | 


及 器 代理 服务 虽 


图 14-4 反问 代理 的 方案 


反问 代理 将 实际 的 Web 服务 器 (在 本 例 中 是 Kestrel 服务 器 ) 与 来 自 各 种 用 户 代理 
的 请 求 完全 隔离 开 。 反 问 代 理 通 党 是 一 个 功能 完善 的 Web 服务 费 ， 能 够 捕捉 传 入 的 
请 求 ， 并 在 执行 一 些 前 期 工作 后 把 请 求 传递 给 后 端 服务 器 。 用 户 代 理 完 全 不 知道 代 

背后 的 实际 服务 器 ， 在 它们 看 来 ， 它 们 真正 连接 到 了 实际 的 服务 器 。 

如 前 所 述 ， 使 用 反问 代理 的 主要 原因 是 安全 和 需要， 以 及 防止 潜在 的 有 害 请 求 传 
入 实际 的 Web 服务 器 。 使 用 反问 代理 的 另外 一 个 原因 是 ， 有 一 个 额外 的 服务 器 层 能 
够 帮助 建立 最 合适 的 负载 平衡 配置 ,可 以 将 IIS( 或 Nginx 服务 器 ) 配 置 为 负载 平衡 弗 ， 
并 控制 连接 到 ASPNET Core 安装 的 实际 服务 器 的 数量 。 例 如 ， 在 耗 时 较 长 的 二 代 
垃圾 回收 操作 中 ， 一 个 进程 不 足以 处 理 请 求 ， 所 以 相同 服务 器 上 的 流量 可 由 应 用 程 
序 的 其 他 实例 处 理 。 另 外 一 种 适合 使 用 反 回 代理 的 场景 是 反问 代理 能 够 简化 SSL 设 
置 的 时 候 。 事 实 上 ， 只 有 有 反 向 代理 才 需 要 SSL 证 书 。 之 后 ， 与 应 用 程序 服务 器 进行 
的 任何 通信 都 可 使 用 普通 的 HTTP 进行 。 最 后 ， 使 用 反问 代理 时 ， 能 够 把 ASPNET 
Core 解决 方案 更 加 顺畅 地 安装 到 现 有 的 服务 器 基础 结构 中 。 


重要 / 


彻底 将 ASPNET Core 设计 为 使 用 自己 的 HITP 服务 器 ， 以 确保 多 种 平台 之 间 
表现 出 一 致 的 行为 。 虽 然 JS、Nginx 和 Apache 都 能 够 用 作 反 向 代理 ， 但 是 它们 也 
都 需要 自己 的 环境 这 就 需要 把 某 种 类 型 的 提供 程 友 模 型 内 置 到 ASP.NET Core 中 。 
因此 ，ASPNET Core 的 开发 团队 决定 在 ASPNET Core 中 公开 一 个 公共 的 、 独 立 的 
HTTP 服务 器 ， 并 且 通 过 做 一 些 额 外 的 配置 工作 或 者 编写 额外 的 插件 ， 把 其 他 Web 
服务 器 插入 到 这 个 外 观 中 。 


2. 将 IIS 配置 为 反 向 代理 


IIS 和 IIS Express 都 可 以 用 作 ASPNET Core 的 反问 代理 。 此 时 , ASPNET Core 
应 用 程序 运行 在 一 个 独立 于 IS 工作 进程 的 进程 中 。 与 此 同时 ，IIS 进程 需要 有 一 个 
专门 的 模块 来 将 IS 工作 进程 和 ASPNET Core 进程 连接 起 来 。 这 个 额外 的 组 件 就 是 
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ASPNET Core ISAPI 模块 。 

ASPNET Core 模块 负责 启动 ASPNET Core 应 用 程序 ， 并 将 HTTP 请 求 转发 给 
该 应 用 程序 。 而 且 ， 它 将 任何 能 够 配置 拒绝 服务 攻击 的 请 求 、 请 求 体 太 长 的 请 求 或 
可 能 超时 的 i 青 求 拒 之 门 外 。 不 只 如 此 ， 这 个 模块 还 负责 在 ASPNET Core 应 用 程序 骨 
演 或 IIS 工作 进程 检测 到 需要 和 至 局 的 条 件 时 ， 重 局 ASPNET Core 应 用 程序 。 

开发 人 员 需 要 确保 IIS 计算 机 上 安装 了 ASPNET Core 模块 。 而 且 ， 在 配置 
ASPNET Core 应 用 程序 的 宿主 时 ， 需 要 调用 UselISIntegration Web 宿主 方法 。 


3. 将 Apache 配置 为 反 向 代理 


要 将 Apache Web 服务 左 配 置 为 一 个 反 回 代理 ， 具 体 要 执行 的 步骤 取决 于 实际 
的 Linux 操作 系统 。 但 是 ， 仍 然 有 一 些 常 规 的 指南 可 以 作为 参考 。 正 确 地 安装 并 运 
行 Apache 以 后 ， 配 首 文 件 将 你 存在 /etc/httpd/conf.d/ 目 隶 中 。 在 这 个 目录 中 ,创建 一 
个 扩展 名 为 .conf 的 新 文件 ， 其 内 容 如 下 : 
<VirtualHost *:80> 
ProxyPreserveHost On 
ProxyPass / http://127.0.0.1:5000/ 


ProxyPassReverse / http://127.0.0.1:5000/ 
</VirtualHost> 


在 示例 中 , 文件 将 Apache 设 壮 为 使 用 交 口 80 监 昕 任何 IP 地址 ， 并 接收 计算 机 
127.0.0.1 上 的 端口 5000 的 所 有 请 求 。 由 于 指定 了 了 ProxyPass 和 ProxyPassReverse， 
所 以 通信 是 双 同 的 。 这 个 步骤 足以 局 用 请 求 的 转发 ， 但 是 不 足以 让 Apache 管理 
Kestrel 进程 。 要 让 Apache 管理 Kestrel 进程 ， 需 要 创建 一 个 服务 文件 。 下 面 的 代码 
是 一 个 文本 文件 ， 告 诉 Apache 如 何 处 理 检测 到 的 请 求 。 


[Unit] 
Description=Programming ASP.NET Core Demo 


[Servicel]| 
WorkingDirectory=/var/progcore/ch1l4/builder 
ExecSstart=/usr/local/bin/dotnet /var/progcore/chl4/builder.d1l 
Restart=always 


i# Restart service after 10 seconds in case of errors 
RestartSec=10 

Syslogldentifijer=progcore—chli4-builder 

User=apache 

ENnvironment=ASPNETCORE ENVIRONMENT=Production 


[Installl 
WantedBy=multi-user.target 


注意 ， 如 果 指 定 的 用 户 不 是 apache， 那 么 必须 首先 创建 指定 的 用 户 ， 并 使 其 拥 
有 文件 。 最 后 ， 必 须 在 命令 行 司 用 该 服务 。 更 多 细节 参 见 https:/docs.microsoft.comy 
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en-us/aspnet/core/publishing/apache-proxy。 该 网 址 提供 的 指示 与 将 Nginx 配置 为 反问 
代理 非常 相似 。 


14.2.3 ” Kestrel 的 配置 参数 


在 ASPNET Core 2.0 中 ，Kestrel 的 公开 编程 接口 变 得 丰富 多 了 。 现 在 很 容易 配 
置 Kestrel 来 支持 HTITPS， 绑 定 到 套 接 字 和 端点 ， 以 及 筛选 传 入 的 请 求 。 


1. 绑 定 到 端点 


Kestrel 提供 了 目 己 的 API， 用 于 绑 定 到 URL 来 监听 传 入 请 求 。 可 以 调用 
KestrelServerOptions 类 的 Listen 方法 来 配置 这 些 闹 点 。 

Var ip=" 
Var host = new WebHostBuilder() 

-UsellSIntegration() 

.UseKestrel (options 三 > 

{ 

options .Listen (IPAddress .Loopback, 2000)，; 


options.Listen (IPAddress.Parse (ip), 1000)，; 
}); 


Listen 方法 接受 IPAddress 类 型 的 实例 。 通 过 Parse 方法 ,可 把 任何 卫 地 址 解析 
为 该 类 的 一 个 实例 。 对 于 本 地 主机 ， 预 定义 的 值 为 Loopback; 对 于 所 有 IPv6 地 址 ， 
预定 义 的 值 为 I Pv6Any; 对 于 随意 的 任何 网 络 地 址 ， 预 定义 的 值 为 Any。 

在 Nginx 上 ， 还 可 以 绑 定 到 UNIX 套 接 字 来 提高 性 能 。 

var host = new WebHostBuilder() 

.UsellISIntegration () 

.UseKestrel (options => 

| options -ListenUnixSocket ("/tmp/progcore—test.sock"); 
}); 

最 终 , 有 3 种 方式 让 Kestrel 知道 监 昕 什么 端点 :UseUrls 扩展 方法 , ASPNETCORE 
URLS 环境 变量 ， 以 及 Listen API。UseUrls 和 环境 变量 提供 的 编程 接口 并 不 只 是 针 
对 Kestrel， 也 可 以 用 在 日 定义 的 (或 者 其 他 可 用 的 )HTTP 服务 器 中 。 但 是 要 注意 ， 
这 些 更 加 通用 的 绑 定 方法 有 一 些 局 限 。 特 别 要 注意 ， 不 能 对 这 些 方法 使 用 SSL。 而 
且 ， 如 果 同 时 使 用 了 Listen API 和 这 些 方法 ，Listen 端点 的 优先 级 更 高 。 最 后 ， 如 
果 使 用 了 IIS 作为 反 回 代理 ，IIS 中 看 编码 的 URL 绑 定 将 重 写 Listen 端点 以 及 通过 
UseUrls 或 环境 变量 设置 的 靖 点 。 


2. 切换 到 HTTPS 


要 使 Kestrel 在 HITPS 上 工作 ， 只 能 使 用 Listen API 指定 病 点 。 下 面 给 出 了 一 
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个 示例 。 


Var host = new WebHostBU1LITLadeT () 

.USeIISIntedTration () 

.UseKestrel (options 三 > 
OpPt1Ions -LISten(IPAdaress .Loopback, S000, listenoptions 三 > 
{ 

Jistenoptions.UseHttps ("progcore.pIlx"”)});} 

}); 

} 

}); 


为 了 启用 HTTPS， 问 Listen 方法 添加 了 第 三 个 参数 ， 用 来 指明 证 书 的 路 径 。 

3. 筛选 传 入 的 请 求 

在 ASPNET Core 2.0 中 ，Kestrel Web 服务 器 变 得 更 加 强大 ， 文 持 更 多 的 配置 选 
项 ， 以 目 动 师 选 挥 超出 了 预 设 约束 的 传 入 请 求 。 而且， 它 可 以 设置 最 大 客户 六 连 接 数 、 
请 求 体 的 最 大 大 小 及 数据 速率 。 


Var host = new WebHostBulillder () 
.USeIISIntedTration () 
.UseKestrel (options 三 > 


OPt1Ions .Limits.MaxConcurrentConnections = 1007 
options.Limits.MaxReaquestBodySize = 10 * 1024; 
options .Limits.MinReaquestBodyDataRate = 
new MinDataRate (bytesPerSecond: 100, gracePerliod: TimeSpan. 
FromSeconds (1O0) ) 
options.Limits.MinResponseDataRate =new MinDataRate 
(bytesPerSecond: 1l00, gracePeriod: TimeSpan. 
FromSeconds (1O0) ) 7， 
} 


}); 


上 面 的 所 有 设置 应 用 到 整个 应 用 程序 的 所 有 请 求 。 
对 于 并 发 连接 数 ， 几 乎 不 存在 限制 ， 但 是 建议 设置 一 个 限制 。 


注意 : 
并 发 连接 的 总 数 中 不 包括 从 HTTP( 或 HITPS) 升 级 到 另 一 个 协议 (可 能 是 
WebSockets) 的 请 求 。 


天 认 情 况 下 ， 将 请 求 体 的 最 大 大 小 设 秆 为 超过 3000 万 字 广 (大 约 28MB)。 无 论 
设置 的 默认 值 是 多 少 ， 都 可 以 通过 操作 方法 的 RequestSizeLimit 特性 重 写 。 另 外 ， 
稍 后 将 看 到 ， 也 可 以 通过 中 间 件 侦 听 器 来 重 与 默认 大 小 。 

注意 ，Kestrel 设置 的 最 小 数据 速率 为 每 秒 240 字 节 。 如 果 在 建立 的 宽 限 期 (默认 
设置 为 $s) 中 ， 请 求 疫 有 发 送 足 有 够 的 字 世 ， 那 么 该 请 求 将 超时 。 可 以 目 己 调整 最 小 和 
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最 大 数据 速率 ， 以 及 相关 的 宽 限期 。 

设置 这 些 限制 的 主要 目的 是 让 Kestrel 更 加 健壮 ， 在 没有 反 向 代理 的 保护 下 向 
Internet 开放 时 ， 能 够 更 好 地 应 对 拒绝 服务 攻击 。 事 实 上 ， 当 Web 服务 器 面 对 淹 没 
攻击 时 ， 这 些 限制 是 常用 的 防御 措施 。 


14.3 ASP.NET Core 的 中 间 件 


发 送 给 ASPNET Core 应 用 程序 的 每 个 请 求 在 到 达 实 际 处 理 请 求 并 生成 啊 应 的 
代码 之 前 ， 会 先 由 配置 好 的 中 间 件 处 理 。 术 语 “ 中 间 件 2” 指 的 是 以 锁链 方式 ( 称 为 应 
用 程序 管道 ) 组 装 在 一 起 的 软件 组 件 。 


14.3.1 管道 架构 


在 请 求 得 到 处 理 并 生成 啊 应 之 前 和 /或 之 后 ， 链 中 的 每 个 组 件 可 以 完成 一 些 工 
作 ， 并 能 够 目 由 决定 是 人 耕 将 请 求 传 递 给 管道 中 的 下 一 个 组 件 ( 如 图 14-5 所 示 )。 


| 
: | 
| ASPNET Core 
| 内 署 服 务 器 可 中 小 问 件 
| 


图 14-5 ASPNET Core 的 管道 


如 图 14-5 所 示 , 管道 是 中 间 件 组 件 组 合 在 一 起 的 结果 。 组 件 链 的 最 后 是 一 个 特 
殊 的 组 件 ， 称 为 终止 中 间 件 。 终 止 中 间 件 触 皮 请 求 的 实际 处 理 ， 然 后 改变 请 求 在 管 
道中 的 前 进 方 各 。 中 间 件 组 件 按照 注册 顺序 调用 ， 来 预 处 理 请 求 。 在 管道 的 最 后 ， 
运行 终止 中 间 件 ， 然 后 相同 的 中 间 件 组 件 有 机 会 对 请 求 进行 后 处 理 ， 但 是 调用 顺序 
与 之 前 相反 (如 图 14-5 所 示 )。 


1. 中 间 件 组 件 的 结构 
中 间 件 组 件 是 由 请 求 委 托 全 权 代 表 的 一 段 代 码 。 请 求 委 托 的 形式 如 下 所 未 。 
public delegate Task RequestDelegate (HttpContext context),; 


换 句 话说， 它 是 一 个 函数 ， 接 收 一 个 HttpContext 对 象 ， 并 进行 处 理 。 根 据 中 间 
件 组 件 在 应 用 程序 管道 中 注册 的 方式 ， 中 间 件 组 件 可 以 处 理 传 入 的 所 有 请 求 ， 也 可 
以 只 处 理 选 定 的 请 求 。 下 面 给 出 了 注册 中 间 件 组 件 的 默认 方式 : 
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app.Use (async (context, next) 三 > 

{ 
// First chance to process the request. No response has been generated for 
// reduest vet. 
<Perform pre-processing of 七 he request> 


// Yields to the next component in the pipeline 
awalt next () ; 


// Second chance to process the request. When here, the request's response 
// has been generated. 
<Perform post-processing of the request> 

}); 

在 把 请 求 转发 给 官 记 中 的 下 一 个 组 件 之 前 和 之 后 运行 的 代码 块 中 ， 可 以 使 用 流 
程控 制 语 句 ， 如 条 件 语句 。 中 间 件 组 件 可 采取 多 种 形式 。 上 和 耐 讨论 的 请 求 委 托 足 其 
中 最 重 早 的 形式 。 

在 本 章 稍 后 将 会 看 到 ,可 以 把 中 间 件 组 件 打包 到 类 中 , 绑 定 到 扩展 方法 。 因 此 ， 
在 局 动 类 的 Configure 方法 中 调用 的 任何 方法 都 可 能 是 中 间 件 组 件 。 


2. 下 一 个 中 间 件 的 重要 性 


调用 next 委托 是 可 选 操作 , 但 是 应 该 非常 清楚 不 调用 next 委托 的 后 果 。 如 果 上 所 
有 中 间 件 组 件 都 没有 调用 next 委托 ， 那 么 处 理 该 请 求 的 整个 管道 将 会 短路 ， 可 能 村 
本 不 会 调用 默认 的 终止 中 间 件 。 

每 当中 间 件 组 件 直接 返回 ， 而 没有 调用 next 中 间 件 时 ， 响 应 生成 过 程 就 在 此 结束 。 
因此 ， 只 要 有 茶 个 中 国 件 组 件 能 够 生成 当前 请 求 的 啊 应 ， 也 可 以 不 调用 下 一 个 组 件 。 

UseMvc 和 UseStaticFiles 是 使 请 求 短 路 的 中 间 件 组 件 。UserMvec 解析 当前 的 
URL， 如 果 能 够 将 其 匹配 到 某 个 文 持 的 路 由 ， 束 将 控制 权 交 给 对 应 的 控制 占 来 生成 
并 返回 啊 应 。UseStaticFiles 在 URL 对 应 于 配置 的 Web 路 径 上 的 茶 个 物理 文件 时 ， 
会 执行 相同 的 操作 。 

如 条 编写 目 己 的 中 间 件 组 件 作为 第 三 方 扩展 ， 那 么 必须 循 规 蹈 托 ， 即 必须 遵守 
相关 的 规则 。 另 一 方面 ， 如 果 组 件 的 业务 远 辑 严格 需要 使 请 求 短路 ， 则 必须 在 文档 
中 完整 记录 这 种 行为 。 


3. 注册 中 间 件 组 件 
可 通过 多 种 方式 将 中 间 件 组 件 添 加 到 应 用 程序 的 管道 中 ， 如 表 14-3 所 示 。 
表 14-3 ”注册 中 间 件 组 件 的 方法 


方法 描述 
Use 其 参数 为 一 个 匿名 方法 ， 可 在 任何 请 求 中 调用 
Map 其 参数 为 一 个 匿名 方法 ， 只 对 指定 URL 调用 
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( 续 表 ) 
方法 摘 述 
MapWhen 其 参数 为 一 个 区 名 方法 ， 只 有 妆 前 请 求 的 给 定 布 尔 仁 条 件 为 
true 时 ， 才 会 调用 
Run 其 参数 为 一 个 匿名 方法 ， 议 首 为 终止 中 间 件 。 如 宁 找 不 到 终止 


中 间 件 ， 就 不 会 生成 啊 应 


注意 ， 可 以 多 次 调用 Run 方法 ， 但 是 只 会 处 理 第 一 次 调用 。 这 是 因为 会 在 Run 
中 完成 请 求 处 理 ， 并 反 转 省 道 链 中 流 的 方 辐 。 第 一 次 找到 运行 中 间 件 时 ， 束 会 发 生 
管道 流向 的 反 转 。 其 后 定义 的 任何 运行 中 间 件 永远 不 会 到 达 。 
public void Configure (IApplicationBuilder app) 
{ 
// Terminating middleware 
app.Run (async context 三 > 
L 


awalt Context .Response.WriteAsync ("Courtesy of ‘Progranming ASP.NET Core'™); 
}); 


// No errors, but never reached 
app.Run (async context 三 > 
{ 
awalt context .RespPponse .WT1IteaAsyYnc (- COUTrtLeSY of ‘Programming 只 SP .NET 
Core' Tepeated") ; 
}); 
} 


中 间 件 组 件 是 在 局 动 类 的 Configure 方法 中 注册 的 。 表 14-3 中 的 方法 的 出 现 顺 
序 设 置 了 代 但 的 执行 顺序 。 


“十 = 
Dy 


一 J 在 使 用 MVC 模型 的 应 用 程序 中 ,可 以 把 Run 终止 中 间 件 用 作 普 遍 适 用 的 路 由 。 
如 前 所 述 ，UseMvc 短路 传 入 的 请 求 ， 把 请 求 重 定向 到 标识 的 控制 器 操作 方法 。 但 
是 ， 如 果 对 于 给 定 请 求 没 有 配置 任何 路 由 ， 则 该 请 求 将 在 管道 中 继续 前 进 ， 直 到 找 
到 一 个 终止 中 间 件 (如 果 有 )。 


14.3.2 ”编写 中 国 件 组 件 


下 面 看 一 些 内 联 中 间 件 组 件 的 例子 ， 即 通过 匿名 方法 表达 的 中 间 件 代码 。 在 本 
草 纤 束 前 ， 还 将 看 到 如 何 把 中 间 件 代码 打包 成 可 重用 的 元 素 。 


1. Use 万 法 
下 面 来 说 明 使 用 Use 方法 注册 中 间 件 组 件 的 基本 方法 。Use 方法 只 是 将 请 求 处 
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理 的 实际 输出 包装 到 BEFORE/ATER 日 志 消 息 中 (如 图 14-6 所 示 )。 
园 localhost x 填 


和 一 [ localhost-50748 


BEFORE 


19:28:16 


AFTER 


图 14-6 ”演示 中 间 件 组 件 


下 面 给 出 了 必要 的 代码 .示例 中 的 SomeWork 类 只 是 通过 方法 Now 返回 当前 的 
时 间 。 


public void Configure (IApplicationBuilder app) 


{ 
app.Use (async (context, nextMiddleware) 三 > 
{ 
awalt Context .Response.WriteAsync ("BEFORE"); 
awalit nextMiddleware (); 
awalt context .Response .WriteAsvync ("AFTER"),; 
}); 
app.Run(async (context) 三 > 
{ 
Var ob] = new SomeWork (); 
await context 
- Response 
.WriteAsync ("<hl style='color:red;'>"™ + obj.Now() + "</h1l>");} 
}); 
} 


可 以 使 用 中 间 件 来 执行 一 些 非 凡 的 任务 ， 或 者 配置 要 测量 的 环境 。 下 面 给 出 了 
为 外 一 个 例子 。 


app.Use (async (context, nextMiddleware) 三 > 
{ 
context .Features 
.Get<IHttpMaxRequestBodySizeFeature>() 
-MaxReaquestBodySize = 10 * 1024; 
awalit nextMiddleware.Invoke () ， 


}}s 


这 里 ， 代 但 使 用 HITP 上 下 文中 的 信息 来 设置 所 有 请 求 的 最 大 请 求 体 大 小 。 只 
是 这 样 ， 代 码 并 没有 什么 晶 思 。 如 采 要 设置 所 有 请 求 的 最 大 请 求 体 大 小 ， 更 好 的 方 


法 是 在 Kestrel 级 别 实现 。 但 是 ， 中 间 件 基础 结构 允许 只 修改 特定 请 求 的 状态 。 


2. Map 方法 


Map 方法 的 工作 方式 与 Use 方法 相同 ， 上 只 不 过 它 只 针对 特定 的 传 入 URL 执行 。 
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app.Map ("/mnow"， now => 


{ 
now.Run (async context 三 > 
{ 
Var time = DateTime.UtcNow.ToString("HH:mm:ss (UTC)™)}; 
awalt context 
-. Response 
.WriteAsync ("<hl style='color:red;'>"™ + time + "</hl>"); 
}); 
}); 


只 有 请 求 的 URL 是 /now 时 ， 上 述 代 人 码 才 会 运行 。 因 此 ，Map 方法 允许 基于 路 
径 让 管道 分 文 (如 疼 14-7 所 示 )。 


器 localhost Xx 二 号 localhaat x 十 


< 位 localhost60748/now | pe 
18:S1:$50 (UTC) BEFORE 


19:S4:32 


AFTER 


图 14-7 不 同 中 间 件 组 件 产生 的 不 同 效果 


如 果 将 上 述 两 种 中 间 件 组 件 组 合 起 来 ， 那 么 注册 它们 的 顺序 会 改变 输出 结 采 。 
一 般 来 说 ， 会 将 Map 调用 放 在 管道 的 前 方 。 


注意 : 

中 间 件 组 件 在 概念 上 对 应 于 经 典 ASPNET 中 的 HTTP 模块 。 但 是 ，Map 方法 
与 HTTP 模块 有 些 关 键 的 区 别 。 事 实 上 ，HTTP 模块 无 法 筛选 URL。 编 写 HTTP 模 
块 时 ， 必 须 自 己 检查 URL， 决 定 是 处 理 还 是 忽略 请 求 。 没 有 任何 办 法 能 够 只 对 特定 
的 URL 注册 HTTP 模块 。 


3. MapWhen 万 法 


MapWhen 方法 是 Map 方法 的 一 个 变 体 。 它 使 用 泛 型 布尔 值 表达 式 ， 而 不 是 URL 
路 径 。 在 下 面 的 示例 中 ， 只 有 答 询 字符 串 表 达 式 包 侣 参数 utc 时 , 才 会 触发 指定 的 处 理 。 


app .MapWhen ( 


context => context.Request .Query.CcontainsKey ("utc"), 
utc => 
{ 
utc.Run (async context => 
{ 
Var 七 Ime = DateTime .UtcNow.ToString(" HH:mm:ss (UTC)}™); 
await context 
- RESsponse 


-WriteAsvync{("<hl style="'color:blue;'>"™ + time + "</hl>"); 
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4. 处 理 HTTP 员 应 


中 间 件 组 件 是 微妙 的 代码 ， 这 是 由 了 HTTP 协议 的 一 条 基本 规则 决定 的 。 写 到 输 
出 流 是 一 个 顺序 操作 。 因 此 ， 一 旦 号 了 (或 开始 号 ) 啊 应 体 ， 驶 不 能 再 添加 HITP 啊 
应 头 。 这 是 因为 在 HITP 啊 应 中 ， 啊 应 头 出 现在 啊 应 体 之 前 。 

只 要 所 有 中 间 件 代 人 码 是 内 联 函数 ， 受 团队 完全 控制 ， 这 束 不 一 定 是 大 问题 ， 而 
且 可 以 轻松 修复 关于 啊 应 头 的 任何 问题 。 那么 , 如 果 要 编写 一 个 第 三 方 中 间 件 组 件 ， 
供 其 他 人 使 用 ， 会 是 什么 情况 ? 在 这 种 情况 下 ， 组 件 必 须 能 够 在 不 同 的 运行 时 环境 
中 运行 。 如 有 果 组 件 的 业务 旬 辑 要 求 修改 啊 应 体 ， 该 怎么 办 ? 

一 旦 代码 将 开始 写 入 输出 流 ， 就 会 阻止 后 面 的 其 他 组 件 添加 HTTP 响应 头 。 
另 一 方面 ， 如 条 需 要 添加 HITP 头 ， 也 可 能 被 其 他 组 件 阻 上 上 。 为 了 解决 这 个 问题 ， 
ASPNET Core 中 的 Response 对 象 公 开本 一 个 OnStarting 事件 。 当 第 一 个 组 件 试图 
写 入 输出 流 时 ， 会 触发 这 个 事件 。 因 此 ， 如 果 中 间 件 需要 与 一 个 啊 应 头 ， 则 只 需要 
注册 OnStarting 事件 的 一 个 处 理 程序 ， 然 后 在 处 理 程序 中 写 啊 应 头 。 


app.Use (async (context, nextMiddleware) => 


{ 
COPntLeXt .ReSPonse .OnStartlIng(() 三 > 
{ 
context.Response.Headers.Add ("courtesy", "Programming ASP.NET Core™);} 
return Task.CompletedTask; 
}); 


await nextMiddleware();} 


| 四- 


本 和 章 到 现在 为 上 上， 讨论 了 内 联 中 间 件 ， 但 是 在 前面 的 草 节 中 ， 见 到 了 许多 专门 的 
扩展 方法 ， 可 在 局 动 类 的 Configure 方法 中 调用 。 例 如 ， 使 用 UseMvcWithDefaultRoute 
配置 MVC 应 用 程序 模型 ， 使 用 UseExceptionHandler 配置 异 第 处 理 。 这 些 都 是 中 间 
件 组 件 。 之 所 以 有 不 同 的 形式 ， 是 因为 那些 中 间 件 代码 被 打包 到 可 重用 的 类 中 。 接 
下 来 就 介绍 如 何 把 目 己 的 中 间 件 打包 到 可 重用 的 类 中 。 


L 在 OnStarting 的 事件 处 理 程序 中 添加 响应 头 ， 大 部 分 时 候 都 可 以 工作 ， 但 是 也 
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存在 一 些 边 缘 生 例 。 特 别 是 ， 有 时 候 必 须 等 待 完整 响应 生成 以 后 ， 才 能 决定 添加 什 
么 头 以 及 头 的 内 容 。 在 这 种 情况 下 ， 可 以 考虑 为 Response.Body 属性 创建 一 种 内 存 
缓冲 区 ， 可 接收 所 有 写 入 ， 但 是 不 会 物理 填充 响应 输出 流 。 当 所 有 中 间 件 组 件 完成 
后 ， 该 缓冲 区 把 所 有 内 容 复 制 到 响应 输出 流 中 。 下 面 这 个 网 址 很 好 地 阐述 了 这 种 思 
想 : https://stackoverflow.com/questions/43403941. 
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14.3.3 打包 中 间 件 组 件 


ee We Ps HTTP gal PE oem ES 


1. 创建 中 间 件 类 


中 间 件 类 就 是 一 个 普通 的 C# 类 , 有 一 个 构造 函数 和 一 个 公有 方法 Invoke。 不 需 
要 基 类 ， 也 不 需要 已 知 的 协定 。 系 统 会 动态 调用 中 间 件 类 。 下 面 的 代码 演示 了 一 个 
中 间 件 类 ， 它 试图 判断 请 求 设 备 是 合 是 移动 设备 。 

public class MobileDetectionMiddleware 


{ 
private readonly RequestDelegate next; 


Public MobileDetectionMiddleware (RequestDelegate next) 
{ 
next = next; 
} 
Public async Task Invoke (HttpContext context) 
{ 
// Parse the user-agent to "duess" if it's a mopile device. 
Var lisMobile = context.IsMobileDevice():; 
context.Items|["MoblileDetectionMiddleware IsMoblile"|] = isMobjle; 


// Yields 
await next (context); 


// Provide some UI only as a proof of existence 
Var msg = lisMobile ?3 "MOBILE DEVICE™ : "NOT A MOBILE DEVICE"; 
await context.Response.WriteAsync ("<hr>" + msg + "<hr>"); 
} 
构造 函数 接收 配置 的 链 (管道 ) 中 指 癌 下 一 个 中 间 件 组 件 的 RequestDelegate 指 
针 ， 并 将 其 保存 到 一 个 内 部 成 员 中 。Invoke 方法 则 包含 原本 想 传递 给 Use 方法 的 代 
公 ( 在 Use 方 法 中 内 联 注 册 中 间 件 的 代码 ),Invoke 方法 的 签名 必须 与 RequestDelegate 
上 和 耐 的 示例 扫描 用 户 代理 HTTP 头 ， 以 确定 请 求 设备 是 否 是 移动 设备 。 在 演示 
中 ，IsMobileDevice 是 HttpContext 类 的 一 个 非常 基础 的 扩展 方法 ， 只 是 使 用 正则 表 
i 找 一 些 移动 设备 风格 的 子 字 符 串 。 如 果 要 把 这 段 代 码 用 在 生产 中 ， 要 深思 
熟 虑 。 它 能 够 识别 大 部 分 设备 ,但 是 也 有 不 少 设备 可 能 无 法 识别 (一 般 来 说 ,设备 检 
站 要 世 科 抽 问题 ， 所 以 可 能 需要 考虑 使 用 一 个 专用 库 来 完成 这 项 工作 ， 更 多 
信息 请 参见 第 13 章 )。 
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不 过 ， 对 于 我 们 的 目的 而 言 ， 这 段 代 码 的 效果 很 好 。 代 码 中 展示 的 一 个 技巧 能 
够 让 中 间 件 组 件 在 相同 请 求 的 上 下 文中 共 至 信息 。 在 确定 了 请 求 设备 是 任 古 移动 设 
备 后 ， 中 间 件 将 布尔 值 结果 保存 到 HttpContext 实例 的 Items 字典 中 。 在 整个 请 求 处 
理 过 程 中 , Items 字典 都 在 内 存 中 共享 , 这 意味 看 任何 中 间 件 组 件 都 可 以 得 看 这 个 字 
段 ， 并 使 用 其 结果 进行 内 部 处 理 。 但 是 ， 要 想 实 现 这 一 点 ， 中 辐 件 组 件 必须 知道 彼 
此 存在 。 移 动 设备 检测 中 间 件 的 效果 是 在 Items 字典 中 存储 一 个 布尔 值 ， 指 出 是 否 
认为 设备 是 移动 设备 .注意 , 在 应 用 程序 中 任何 能 够 访问 HttpContext 对 象 的 地 方 (如 
控制 礁 方 法 中 )， 都 可 以 通过 代码 访问 这 种 信息 。 

2. 注册 中 间 件 类 

要 添加 中 间 件 类 ， 需 要 使 用 与 IApplicationBuilder 接口 稍微 不 同 的 方法 。 因 此 ， 
在 局 动 类 的 Configure 方法 中 ， 使 用 下 面 的 代 但 : 

public void Configure (IApplicationBuilder app) 


{ 


// Other middleware configured here 
// Attach the mobile-detection middleware 
app.UseMiddleware<MobileDetectionMiddleware> ();} 
// Other middleware configured here 
} 
UseMiddleware<T> 方 法 将 指定 类 型 注册 为 一 个 中 间 件 组 件 。 
3. 通过 扩展 方法 注册 
定义 一 个 扩展 方法 来 隐藏 使 用 的 UseMiddleware<T> 方 法 ， 是 一 种 常见 的 做 法 ， 
尽管 从 纯粹 的 功能 的 角度 看 ， 并 不 是 必须 这 么 做 。 效 果 是 相同 的 ， 但 是 代码 的 可 读 
性 提高 了 。 


public static class MobileDetectionMiddlewareExtensions 


{ 
Public static IApplicationBulilder UseMobjleDetection (this IApplicationBuilder 
builder) 
{ 
return builder.UseMiddleware<MoblileDetectionMiddleware> () 
} 
} 


要 为 IApplicationBuilder 类 型 编写 这 样 的 扩展 方法 ， 只 需要 儿 行 代码 ， 将 对 
UseMiddleware<IT> 的 直接 调用 隐 基 到 一 个 名 称 友好 的 方法 后 面 。 下 面 给 出 了 使 用 上 
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public void Configure (IApplicationBuilder app) 
{ 


// Other middleware configured here 


// Attach the mobile-detection middleware 
app .UseMobileDetection(); 


/ Other middleware configured here 
} 


虽然 可 以 随意 选择 扩展 方法 的 名 称 ， 但 是 通常 使 用 UseXXX 这 样 的 名 称 ， 其 中 
XXX 是 中 间 件 类 的 名 称 。 


14.4 小结 


如 果 从 应 用 程序 的 角度 看 ASPNET Core, 不 会 看 到 它 与 经 典 ASPNET MVC 相 
比 有 太 多 变化 。ASPNET Core 支持 相同 的 MVC 应 用 程序 模型 ， 但 是 在 完全 不 同 的 
运行 时 环境 之 上 实现 这 种 支持 。ASPNET Core 不 支持 Web Forms 模型 , 但 这 不 是 纯 
粹 的 商业 决策 ， 而 是 单纯 的 技术 问题 。 

新 的 ASPNET Core 运行 时 全 新 设计 为 跨 平 台 ， 与 Web 服务 器 环境 解 厢 。 为 了 
实现 在 多 个 平台 上 运行 这 个 终极 目标 ，ASPNET Core 引入 了 自己 的 宿主 环境 ， 并 提 
供 了 一 个 接口 来 将 其 连接 到 实际 的 宿主 。 在 这 个 上 下 文中 ，dotnet.exe 工具 扮演 了 关 
键 的 角色 ， 它 实际 连接 到 Web 服务 器 ， 并 将 调用 转发 给 ASPNET Core 管道 。 在 
ASPNET Core 管道 中 ， 内 部 的 HITP 服务 器 Kestrel 接收 并 处 理 请 求 。 

本 章 首 先 分 析 了 和 窒 主 服务 器 架构 ， 并 重点 介绍 了 Kestrel， 然 后 介绍 了 中 间 件 组 
件 。 中 间 件 组 件 构成 了 内 部 请 求 管道 ， 即 处 理 任何 传 入 请 求 的 一 个 锁链 。 虽 然 中 间 
件 组 件 在 概念 上 相当 于 经 典 ASPNET 的 HTTP 模块 ,但 是 中 间 件 组 件 具 有 不 同 的 结 
构 ， 并 通过 不 同 的 工作 流 调 用 。 

第 15 章 将 探讨 ASPNET Core 应 用 程序 的 部 普 ， 以 及 将 独立 于 平台 的 应 用 程序 
部 普 到 具体 平台 需要 的 步骤 。 
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部署 ASP.NET Core 应 用 程序 


有 时 候 旅 行 的 过 程 比 抵达 目的 地 更 好 . 
一 一 罗伯特 。 波 西 格 , 《 禅 与 摩托 车 维修 艺术 》 


编写 ASPNET Core 应 用 程序 需要 创建 和 编辑 多 个 文件 ， 但 如 果 将 应 用 程序 部 
普 到 生产 服务 髓 或 暂 存 服务 器 , 并 不 是 所 有 文件 都 是 必须 有 的 。 因 此 , 部 着 ASPNET 
Core 应 用 程序 的 第 一 步 ， 是 将 应 用 程序 上 友 布 到 一 个 本 地 文件 严 ， 编 译 必 要 的 文件 ， 
并 将 这 些 需要 移动 到 生产 环境 的 文件 单独 保存 。 需 要 部 普 的 文件 通 间 包括 源 代 人 码 文 
件 编 详 成 的 DLL 文件 ， 以 及 静态 文件 和 配置 文件 。 

盟 型 的 ASPNET 应 用 程序 只 能 部 普 到 Windows 服务 器 操作 系统 的 IS 中 ,近来 
也 可 以 部 署 到 Microsoft Azure 应 用 服务 中 。 对 于 ASPNET Core 应 用 程序 ， 可 选项 
更 多 , 包括 Linux 本 地 计算 机 或 云 环境 , 如 Amazon Web Services(AWS), 其 至 Docker 
容 艇 。 

本 章 将 探讨 各 种 部 署 选项 和 最 重要 的 配置 问题 。 但 是 ， 首 先 需 要 了 解 如 何 发 布 
ASPNET Core 应 用 程序 。 


15.1 发 布 应 用 程序 


建议 通过 基本 的 发 布 步 又 理解 部 普 模 型 , 如 果 了 刚刚 接触 ASPNET 开发 或 ASPNET 
MVC 应 用 程序 模型 ， 更 应 该 这 么 做 (这 里 假定 你 已 经 部 悉 了 ASPNET Web Forms 
开发 )。 
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15.1.1 在 Visual Studio 内 发 布 应 用 程序 


首先 ， 假 设 已 经 有 了 一 个 完整 的 、 全 和 面 测 试 过 的 应 用 程序 准备 部 普 。 可 以 使 用 
本 书 配 侠 源 代码 中 的 SimplePage 应 用 程序 作为 例子 (参见 https://github.com/despos 
/ProgCore/tree/master/Src/Ch15)。, 图 15-1 显示 了 Visual Studio 中 用 于 局 动 发 布 过 程 的 
豆单 项 。 


| Chi5.SimplePage - Nlicrosoft Visual Studio 同 Quick Launch (Ctl+O) 由 一口 

File Edit View Project Build | Debug Team Tools Test ReSharper Analyze Window Help Dino Esposito ™ 

Build Solution Ctrl+shift+B -Any CPU -hb I 晤 Bpress * 画 也 -| 十 
Rebuiild Salutian ; 


Solution Explorer 
Clean Solution sin hs 
Run Code Analysis on Solutian Blt+F11 | = 引 了 四- 所 印 四 | £ -| 

到 Build Ch15.SimplePage Search Solution Explorer (Ctr|+ 


Rebuild Ch15.Simplepage 9] solution Chis.sSimplePage’ (1 project) 


4 Si Chi 5.SimplePage 


Clean Chi5.SimplePage . 
上 Connected Services 


Pack Ch15.SimplePage 
ack C SimplePage ; hb er Dependencies 
Re-compile all files in solutian Shift+Alt+Y bP a wwwroot 
b a pages 
Update All Bundles Shift+Alt+| 天 
bh rc programcs 
Configuration Manager... 二 Et Startup.cs 


Configure Continuous Delivery... 


Project File Chis.SimplePage.csproj 
Praject Folder Dbly Demos\cCore TheBocoi\Program 


UserSecretsId 


图 15-1 准备 好 发 布 一 个 ASPNET Core 应 用 程序 
1. 选择 发 布 目标 
在 Visual Studio 中 单 击 Build 菜单 下 的 Publish 命令 后 ， 会 看 到 另外 一 个 视图 ， 
用 于 选择 将 文件 发 布 到 什么 地 方 (如 图 15-2 所 示 )。 
对 于 应 用 程序 文件 ， 有 几 个 可 选 目标 ， 如 表 15-1 所 示 。 注 意 ， 表 15-1 中 列 出 
的 选项 比 图 15-2 中 显示 的 更 多 ; 不 过 在 图 15-2 所 示 的 视图 中 ， 单 击 癌 右 箭头 可 以 
看 到 更 多 选项 。 


表 15-1 Visual Studio 2017 支持 的 大 部 答 主 


鸽 主 摘 述 
Microsoft Azure App Service 将 应 用 程序 发 布 到 新 的 或 现 有 的 Microsoft Azure App 
Service 中 


Microsoft Azure Virtual Machine 将 应 用 程序 发 布 到 现 有 的 Microsoft Azure 虚拟 机 中 
TIS 应 用 程序 将 通过 FTP、WebDeploy 或 者 直接 复制 必要 的 文 
件 ， 发 布 到 指定 的 TS 实例 中 
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( 续 表 ) 
宿主 描述 
Folder 将 应 用 程序 发 布 到 本 地 计算 机 上 的 文件 系统 的 指定 文件 夹 中 
Import profile 使 用 保存 的 信息 将 应 用 程序 发 布 到 publishsettings 文件 中 


-| chis.SsimplePage - Microsoft Visual Studio 了 P=- ODO x 
File Edit Wew Project Build Debug Team Tools Test Resharper Analyze Window Help Dino Esposito ™ 


“| Debug | | Any CPU -| PilsExpress -7 -| - _ 


俯 部 -| 名 "与 铝 蝗 | 三 
Overview Publish Search Solution Explorer (Ctrl+) PA: 
a9] Solution 'Ch15,.SimplePage' (1 project) 
i 4 + Chis.SimplePage 
: Publish Connected Services 
er 口 门 sh Dependendes 
二 a Properties 
DD | a wwwroot 


i Pages 
Microsott rT IlS, FTP_ ete 
Bpp Service 


Connected Services Publish your app to Azure or another host. Laarn more 


b +ce Program.cs 
bb + Startup.cs 
Create New 


0) Select Existine Publish | 
i Solutio... 加 时 T= 


中 器 直 36 Eh Programming ASP.NET Core SR master 过 


图 15-2 ”选择 宿主 


为 了 了 解 有 哪些 必须 友 布 的 文件 ， 选 掺 Folder 选项 。 

需要 注重 ， 如 采 项 目 还 不 包 舍 发 布 配置 文件 ， 则 只 会 看 到 图 15-2 所 示 的 选项 。 
一 旦 开始 操作 目标 ， 恕 会 创建 一 个 及 布 配 着 文件， 页 面 会 目 动 显示 上 次 使 用 的 配置 
文件 ， 并 提出 创建 一 个 新 的 配置 文件 。 


2. 发 布 配置 文件 


上 发布 配置 文件 是 .pubxml XML 文件 ， 保 存在 项 目的 Properties/PublishProfiles 文 
件 夹 中 。 不 应 该 把 这 个 文件 签 入 源 代码 管理 系统 ， 因 为 它 依赖 于 .user 项 目 文件 ， 而 
后 者 可 能 包含 敏感 信息 。 这 两 个 文件 只 用 在 本 地 计算 机 上 。 

.pubxml 文件 是 一 个 MSBuild 文件 ， 在 Visual Studio 中 生成 应 用 程序 时 会 日 动 
调用 这 个 文件 。 可 以 修改 这 个 文件 来 定制 期 望 的 行为 。 典 型 的 修改 是 在 部 昔 中 包 
舍 或 排除 项 目 文件 。 更 多 信息 可 访问 https://docs.microsoft.com/en-us/aspnet/core/ 
publishing/web-publishing-vs. 
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3. 将 文件 发 布 到 本 地 文件 夹 


当选 择 发 布 到 文件 夹 时 ， 显示 的 界面 如 图 15-3 所 示 。 在 文本 框 中 可 选择 实际 接 
收文 件 的 文件 夹 。 


| Ch15.5implePage - Microsoft Visual Studio | Ouick Launch (Ctrl+ 0) P= 日 其 


Fle Edit Wiew Propgct Build Debug Team Tools Test Rasharper Analyze Window Halp Dins Esposito ~ 国 


: 全- | 菏 = 名 = | Release = |Any CPU - 1 晤 Expressv 硬 了 由 -| 国 


= |Solution Explorer 
洗 锅 -| 百 - 气 印 四 | 慑 


人 werwieey Publish aarch Salutinn Feplorer (Ctri+ Pr" 


| i am] Solution Ch15.SimplaPage' (1 prajedt) 
Connected Services Publish your app to Azure or another host. Learn more dl es eg 


4 + ] Ch15.SimplePage 


口 b sr Dependencies 


[Le bap Properties 
- 竹 ] 本 | : b a nam oot 


. | b a Pages 
Micresoft Arure lls, FTR, ete wa 
fi Program,.cs 


Bb + cs Starbup,cs 


Choose a folder 
bim Raelease\ Publishoutpyut 


EE Programming ASP,NET Core master = 人 有 


图 15-3 发布 到 本 地 文件 夹 


发 布 过 程 将 在 Release 模式 下 从 头 开始 编译 应 用 程序 , 并 将 所 有 二 进 制 文件 复 
制 到 指定 的 文件 夹 中 。 还 将 自动 创建 一 个 发 布 配置 文件 ， 供 将 来 重复 这 个 操作 (如 
图 15-4 所 示 )。 


过 ch1ssimplepage - Microsoft Visual Studio Ouick Launch (Chl+ P=- © X 


Fle Edt View Praoct Buld Debug Team Tools Test Resharper Analyze Window Halp Ding Esposito ™ 国 


i- | 闪 ~ 名 局 弟 本 Release = 由 AnyepPU "lSExpress 和 让 7 半 - 


= | Solution Explorer 
仙 总 -| 加 "5 站 加 | 
Publish SaarEh Shution Expleorar [世间 谢 要 


5 五 看 | 2 Ca 


i] Sohuticn ‘Ch1 5.SimplePage’ (1 project) 
a + | Ch15.SimplePage 

Connected Services 

= Dependenckes 

bagp Properties 

bs waroot 

b aM Pages 


Publish your app to Azure or another host Learn more 


到 FolderProfile Publish Bb 


Create rew profile 


kb #5: program.cs 


summary hh + cr Startup.cs 


Targat Location bimReleasePublshOutput OH TL 


Calete Esting Files False Renarre prolile.., Build Be. Tomrr Ex. pe 
Configuration Relaase Delele profile 


| Properties 二 轩 六 


Lr Publsh succeeded 
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如 果 查 看 示例 项 目的 文件 夹 , 可 找到 WWWROOT 文件 夹 和 二 进 制 文件 。 注意 ， 
示例 项 目 没 有 视图 ， 而 是 使 用 了 Razor 负面。 无 论 如 何 ， 图 15-5 中 并 没有 显示 有 视 
图 文件 的 文件 兴 ， 无 论 是 Pages 还 是 Views。 在 这 两 种 情况 中 ，Razor 视图 都 会 预 纺 
译 成 DLL。 在 Visual Studio 2017 创建 的 ASPNET Core 2.0 的 项 目 模板 中 ， 默 认 局 用 
了 了 预 编 详 视 图 。 要 改 为 局 用 动态 编译 的 视图 ， 需 要 在 项 目的 CSPROJ 文件 中 添加 下 
面 加 狙 显示 的 代码 。 

<PropertyGroup> 

<TargetFramework>netcoreapp2.0</TargetFramework> 
<MvcRazorCompileOnPublish>false</MvcRazorCompileOnPublish> 
</PropertyGroup> 
| | Ds |PublishOutput 
Home share View 
车 % ove to ™ elete ™ 是 \ a | 围 
~” 挤 置 |[& Moveto” XK Delet 用 站 Vv 加 
Pinto Quick Cop Paste 和 onto | ED Rename New Properties elex 
Se Ee 日 Bc ee 1 folder 的 © 2 
Clipboard Organize New Open 
< v 个 有 “Relea.. > PublishO.. YO Search PublishOutput 


A 


© .idea 全 Name 


PP 
LA 
| 
A 


wwwroot 
ch01 J Ch15.SimplePage.deps.json 

Ch02 S| Ch15.SimplePage.dll 

Ch03 全 Ch15.SimplePage.PrecompiledViews.dll 
Chod 有 Ch15.SimplePage.runtimeconfig.json 
ChOs 访 web.config 

Ch06 

Ch07 

Ch08 

上 Cho9 


6 items 1 item selected 


和 
和 


图 15-5 发 布 的 文件 


可 以 看 到 ， 应 用 程序 的 发 布 文件 夹 只 包含 应 用 程序 的 二 进 制 文件 ， 其 中 包括 所 
有 第 三 方 依赖 .通过 在 命令 行 启 用 dotnet 实用 程序 , 或 者 配置 宿主 Web 服务 器 环境 ， 
可 启动 主 DLL 文件 。 

这 里 要 重点 注意 的 是 ， 发 布 的 文件 配置 了 一 种 可 移植 的 、 依 赖 于 框架 的 部 署 。 
换 句 话说 ， 应 用 程序 要 想 正确 运行 ， 服务 器 上 必须 有 目标 平台 的 .NET Core 框架 库 。 


4. 发 布 自 包含 的 应 用 程序 


在 ASPNET 平台 的 整个 生命 周期 中 , 发 布 可 移植 的 应 用 程序 一 直 是 常态 。 部 团 
很 小 ， 仅 限于 应 用 程序 的 二 进 制 文件 和 静态 文件 。 在 服务 器 上 ， 多 个 应 用 程序 共享 
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同一 框架 二 进 制 文件 。 在 .NET Core 中， 相对 于 可 移植 部 署 ， 还 可 以 发 布 目 包含 的 
应 用 程序 。 

发 布 目 包含 的 应 用 程序 时 ， 也 会 复制 指定 运行 时 环境 的 .NET Core 二 进 制 文件 。 
这 使 部 署 的 大 小 增加 了 很 多 。 对 于 这 里 讨论 的 示例 应 用 程序 ， 可 移植 部 署 的 大 小 不 
到 2MB， 但 是 对 于 针对 通用 Linux 平台 的 自 包 含 安 装 ， 则 会 增加 到 90MB。 

但 是 ， 自 包含 应 用 程序 的 优点 是 ， 无 论 服 务 器 上 安装 了 什么 版 本 的 .NET Core 
Framework， 应 用 程序 都 有 目 己 在 运行 时 需要 的 一 切 文 件 。 与 此 同时 ， 需 要 注意 ， 
在 系统 中 部 普 几 个 目 包 含 的 应 用 程序 ， 会 消耗 大 量 磁 盘 空 间 ， 因 为 在 每 个 应 用 程序 
中 都 会 包含 完整 的 NET Core 框架 。 

为 了 文 持 以 目 包 合 方 式 部 着 给 定 的 应 用 程序 ， 必 须 显 式 添 加 想 要 文 持 的 平台 的 
运行 时 标识 符 。Visual Studio 创建 新 的 NET Core 项 目 时 ， 不 包含 这 种 信息 ， 所 以 会 
生成 可 移植 的 部 普 。 要 局 用 目 包 含 的 部 署 ， 必 须 手 动 编辑 .csproj 项 目 文件 ， 并 在 其 
中 添加 一 个 RuntimeIdentifiers 玉 点 。 下 和 面 给 出 了 示例 项 目的 .csproj 文件 的 内 容 。 


<Project Sdk="Microsoft .NET .SqK .Wep > 
<PropertyGroup> 
<TargetFramework>netcoreapp2.0</TargetFramework> 
<RuntimelIdentifiers>winl0-x64:linux-x64</Runtimeldentifiers> 
</PropertyGroup> 
<TItemGroup> 
<None Remove="Properties\PublishProfiles\FolderProfile.pubxml™" /> 
</ItemGroup> 
<TItemGroup> 
<PackageReference Include="Microsoft.AspNetCore.All™ Version="2.0.0™ /> 
</ItemGroup> 
<TItemGroup> 
<DotNetCliToolReference 
Include="Microsoft .VisualSstudio.Web.CodeGeneration.Tools™" Version= 
"300.0 /3 
</ItemGroup> 
<TtemGroup> 
<Folder Include="Pages\Shared\" /> 
<Folder Include="Properties\PublishProfiles\™" /> 
</ItemGroup> 
</Project> 


当前 项 目 可 部 署 到 Windows 10 和 统一 的 Linux x64 平台 。 在 RuntimeIdentifiers 
方 点 中 使 用 的 名 字 来 目 官方 目录 ， 可 在 以 下 网 址 查看 其 文档 : https://docs.microsoft. 
com/en-us/dotnet/core/rid-catalog. 

现在 ， 把 应 用 程序 用 布 到 文件 夹 时 ， 回 导 会 提示 从 发 布 配 置 文件 的 设置 中 选择 
目标 平台 。 网 15-6 分 别 显示 了 可 移植 场景 和 目 包 含 场景 下 的 视图 。 

把 要 发 布 的 文件 保存 到 文件 夹 以 后 ， 只 需要 把 它们 上 传 到 最 终 目标 。 如 果 选 择 
另外 一 个 发 布 选 项 (如 Azure App Service)， 那 么 上 传 操作 将 是 透明 的 。 
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Fublish 4 的 总 bs 
狼 ) publish Publish 


FolderProfile ee FolderProfile 


iCeanfiguration: Release | Contiguration Pelease 


iTarget FErasmeweonk: | nebooreaPPpe 5 : Target Framework: | metcoreapgp2oi 
i Target Runtime: Portable i Target Runtime: immu 


i File Publish Options i wr File Publish Op ed > = = = < renmnrrrermmemrmmenr r r | 


图 15-6 ”可 移植 发 布 与 运行 时 发 布 
15.1.2 ”使 用 CLI 工具 发 布 应 用 程序 


在 Visual Studio 2017 中 执行 的 操作 ， 也 可 以 在 命令 行 中 使 用 CLI 工具 执行 。 使 
用 命令 行 时 ， 可 以 使 用 自己 惯用 的 IDE 编辑 器 来 编写 代码 。 如 果 使 用 Visual Studio 
Code， 则 可 以 使 用 View 订单 的 Integrated Terminal 命令 来 打开 一 个 命令 控制 台 (如 
图 15-7 所 示 )。 


SimplePage - Visual studio Code 
File Edit selection View Soe Debug Tasks Help 
EXPLORER 
a CPEN EDITORS 


a SIMPLEPAGE 


TERMWINAL 1: powershell ™ 中 曾 六 国 x 
Windows PowerSshell 
Copyright (cc) 2816 Microsoft Corporation., All rights reserved. 


PS D:\My Demos\Core\TheBook\Programming ASP.NET Core\Src\Ch1ls\SimplePage> 


图 15-7” Visual Studio Code 终 六 
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1. 发 布依 赖 于 框架 的 应 用 程序 


完成 并 全 面 测 试 了 应 用 程序 后 ， 可 在 CSPROJ 文件 夹 中 使 用 下 面 的 命令 来 发 布 
应 用 程序 。 


dotnet publish -于 netcoreapp2.0 -C Release 


命令 行 在 Release 模式 下 编译 ASPNET Core 2.0 应 用 程序 ， 并 将 产生 的 文件 放 
到 项 目的 Bin 文件 夹 下 的 Publish 子 目录 中 。 更 准确 地 说 ， 这 个 文件 夹 是 : 


\bin\Release\netcoreapp?.0\publish 


注意 ，dotnet 工具 在 复制 必要 的 二 进 制 文件 时 ， 还 会 复制 PDB 文件 (程序 数据 
库 )。PDB 文件 主要 用 于 调试 ， 不 应 该 将 其 分 发 出 去 。 但 是 ， 应 该 把 这 些 文件 保存 
到 条 个 地 方 ， 因 为 发 生 不 可 预测 的 卉 党、 馈 译 和 其 他 不 当 行 为 时 ， 可 能 种 要 调试 应 
用 程序 的 Release 版 本 ， 这 些 PDB 文件 束 会 很 有 帮助 。 

2. 发 布 自 包 含 的 应 用 程序 

对 于 日 包含 的 应 用 程序 ， 使 用 的 命令 行 只 是 和 有 区 别 。 基 本 上 ， 和 需要 在 发 布依 
赖 于 框 娘 的 应 用 程序 时 使 用 的 命令 行 中 ， 添 加 运行 时 标识 符 。 

dotnet publish -f netcoreapp2.0 -cc Release -IT WlIn1L0O-X6d 

上 面 的 命令 行将 针对 Windows x64 平台 发 布 文件 ， 总 大 小 超过 了 96MB。 文 件 
将 保存 到 下 和 面 的 目标 文件 炎 中 : 

\bin\Release\netcoreapp?2.0\winl0-x64\publish 

为 了 指定 运行 时 标识 从 ， 需 要 使 用 .NET Core 目录 (https://docs.microsoft. 
com/en-us/dotnet/core/rid-catalog) 中 的 官方 ID。 

注意 : 

如 果 要 发 布 的 应 用 程序 依赖 于 第 三 方 组 件 ， 那 么 在 发 布衣 ， 需 要 确保 把 依赖 添 
加 到 .csproj 文件 的 <ItemGroup> 书 中 ， 并 且 确 保 实 际 的 文件 在 本 地 NuGet 缓存 中 可 用 。 


15.2 部署 应 用 程序 


发 布 步 又 非常 必要 ， 可 以 隅 离 要 复制 的 文件 。 在 Visual Studio 中 ， 有 许多 工具 
可 本 地 友 布 文件 ， 或 者 将 文件 百 接 友 布 到 IS 或 Microsoft Azure。 其 他 选项 ， 如 部 
署 到 Linux 本 地 计算 机 或 另外 一 种 云 平 台 ( 如 Amazon Web Services)， 需 要 做 指定 的 
上 传 和 配置 工作 。 
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下 面 详 细 介绍 如 何 把 应 用 程序 完整 部 署 到 IIS、Azure 和 Linux 计算 机 。 
15.2.1 部 署 到 |IS 


ASPNET Core 应 用 程序 在 IIS 的 核心 进程 和 IIS 工作 进程 (w3wp.exe) 的 实例 之 
外 运行 。 从 技术 上 讲 ，ASPNET Core 应 用 程序 甚至 不 需要 在 前 问 有 一 个 Web 服务 
器 。 如 果 把 应 用 程序 部 车 到 IIS( 或 Apache)， 只 是 因为 我 们 有 理由 (主要 是 安全 性 和 
负载 平衡 ) 在 ASPNET Core 内 置 的 原生 Web 服务 器 之 上 添加 外 观 。 


1. 宾主 架构 


如 前 所 述 ， 和 典型 的 ASPNET 应 用 程序 托管 在 应 用 程序 池 中 , 这 个 应 用 程序 池 由 
IIS w3wp.exe 工作 进程 的 实例 代表 。IIS 内 置 的 一 些 NET 设施 负责 创建 针对 应 用 程 
序 的 HttpRuntime 关 的 实例 。 此 对 象 用 于 接收 http.sys 驱动 程序 捕捉 到 的 请 求 ， 并 把 
这 些 请 求 转发 给 在 应 用 程序 池 中 分 配 的 相应 网 站 。 

图 15-8 给 出 了 ASPNET Core 应 用 程序 的 ITS 窒 主 架构 。ASPNET Core 应 用 程 
序 是 一 个 普通 的 控制 台 应 用 程序 ， 通 过 dotnet 启动 工具 的 run 命令 加 载 。ASPNET 
Core 应 用 程序 不 会 在 IS 工作 进程 内 加 载 和 局 动 。 相 反 , 它们 是 通过 一 个 额外 的 IIS 
原生 ISAPI 模块 ( 称 为 ASPNET Core 模块 ) 触 发 的 。 这 个 模块 最 终 会 调用 dotnet 来 触 
发 控制 台 应 用 程序 。 


HIIP 


应 用 程序 池 
网 站 1, 网 站 2 


ASP.NET Core ASPNET Core 


ASPNET Core 
应 用 程序 


图 15-8 在 Is 中 托管 ASPNET Core 应 用 程序 


因此 , 要 在 IIS 计算 机 上 托管 ASPNET Core 应 用 程序 , 首先 需要 安装 ASPNET 
Core ISAPI 模块 。 
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区 ASPNET Core ISAPI 模块 只 能 用 于 Kestrel。 如 果 在 ASPNET Core 2.0 中 使 用 
HttpSys( 或 者 在 ASPNET Core 1.x 中 使 用 WebListener)， 该 模块 不 可 用 。 更 多 信息 请 
访问 https://docs.microsoft.com/en-us/aspnet/core/fundamentals/servers/aspnet- core-module。 
该 网 址 还 提供 了 下 载 的 细 字 。 


2. ASP.NET Core 模块 的 配置 


ASPNET Core 模块 的 工作 就 古 确 你 在 收 到 对 应 用 程序 的 第 一 次 请 求 时 , 正确 地 
局 动 应 用 程序 。 男 外 ， 还 会 确 你 进程 保留 在 内 存 中 ， 如 采 应 用 程序 朋 演 并且 应 用 程 
施 池 重 局 ， 束 重新 加 载 进程 。 
可 能 已 经 注 间 到， 发 布 同 导 还 创建 了 一 个 web.config 文件 。 这 个 文件 不 会 影 
啊 应 用 程序 的 实际 行为 ， 只 用 来 在 IIS 中 配置 ASPNET Core 模块 。 下 面 给 出 了 一 
个 示例 。 
<2xml] version="1 .0™ encoding="utf--8"?> 
<cConfiguration> 
<System.webServer> 
<handlers> 
<add name="aspNetCore™” path="*" wverb="*™ 
modules="AspNetCoreModule" resourceType="Unspecified™ /> 
</handlers> 
<aspNetCore processPath="dotnet"™" arguments=".\Chl5.SimplePage.dll1" 
stdoutLogEnabled="false™" stdoutLogFile=".\logs\stdout™ /> 
</system.webServer> 
</configuration> 
配置 文件 添加 了 动词 和 路 径 的 HTTP 处 理 程序 ， 它 通过 模块 中 编写 的 代码 沛 选 
请 求 。 路 径 中 的 通配符 意味 着 ASPNET Core 模块 会 处 理 所 有 通过 应 用 程序 池 的 请 
求 ， 包 括 ASPX 请 求 。 因 此 ， 建 议 不 要 在 同一 个 应 用 程序 池 中 混合 依赖 于 不 同 
ASPNET 框架 的 应 用 程序 ， 最 好 创建 一 组 专门 的 ASPNET Core 应 用 程序 池 。 
aspNETCore 项 则 为 模块 所 供 了 参数 。 该 项 指出 , 模块 必须 对 指定 的 应 用 程序 域 
DLL 运行 dotmet， 还 指定 了 一 些 日 志 记 录 配 置 。 在 部 署 中 必须 包含 这 个 web.config 
文件 。 


注意 : 

要 成 功 地 在 JIS 中 托管 , ASPNET Core 应 用 程序 必须 通过 调用 UseIISIntegration 
扩展 方法 来 配置 Web 和 宿主。 该 方法 会 检查 一 些 ASPNET Core 模块 可 能 已 经 设置 好 
的 环境 变量 。 如 果 没 有 找到 环境 变量 ， 则 该 方法 无 用 。 因 此 ， 无 论 最 终 在 什么 地 方 
托管 应 用 程序 ， 可 能 总 要 调用 该 方法 


350 


第 15 章 部 署 ASPNET Core 应 用 程序 


3. 关于 1|S 环境 的 最 后 介绍 

如 果 将 ASPNET Core 应 用 程序 部 署 到 IIS, 则 说 明 想 要 使 用 HS 作为 反 向 代理 。 
这 意味 看 IIS 上 只 是 将 流量 原封 不 动 地 转发 ， 并 不 期 望 IS 对 请 求 做 任何 处 理 。 因 此 ， 
可 以 配置 应 用 程序 池 ， 这 样 应 用 程序 池 不 使 用 托管 代码 ， 从 而 不 会 实例 化 任何 .NET 
运行 时 (如 图 15-9 所 示 )。 


Add Application Pool 


.NET CLR version: 


No Managed Code 
Managed pipeline mode: 
Integrated YY 


Start application pool immediately 


图 15-9 创建 专用 的 应 用 程序 池 


天 于 IS 配置 ， 需 要 天 注 的 另 一 方面 是 托管 ASPNET Core 应 用 程序 的 应 用 程序 
池 背 后 的 喘 份 ,默认 情况 下 , 任何 新 应 用 程序 池 的 映 份 都 设 为 ApplicationPoolIdentity。 
这 并 不 是 真实 的 账户 名 称 ， 只 是 一 个 名 字 对 象 ， 对 应 于 IIS 创建 的 本 机 账户 ， 并 根 
据 应 用 程序 池 命名 。 

因此 ， 如 果 需 要 为 给 定 资源 (如 服务 器 文件 或 文件 夹 ) 定 义 访 问 控制 规则 ， 则 应 
该 知道 ， 真 实 的 账户 名 是 IS APPPOOL\AspNetCore， 如 图 15-9 所 示 。 虽 然 如 此 ， 
但 不 是 必须 接受 默认 账 己 。 通 过 使 用 常规 的 HS 界面 ， 可 以 在 任何 时 候 将 应 用 程序 
池 背 后 的 身份 改 为 任意 用 户 账户 。 


15.2.2” ”部署 到 Microsoft Azure 


除了 部 团 到 安装 有 IIS 的 本 地 服务 器 ,还 可 以 在 Microsoft Azure 中 托管 ASPNET 
Core 应 用 程序 。 有 几 种 方式 可 在 Azure 中 托管 网 站 。 最 党 用 、 也 是 推荐 为 ASPNET 
Core 应 用 程序 使 用 的 方法 是 使 用 App Service。 在 某 些 特定 场景 中 , 可 以 考虑 Service 
Fabric， 甚 全 在 Azure Virtual Machine 中 托管 。 最 后 这 个 选项 最 接近 已 经 介绍 过 的 托 
管 场 景 : 在 IIS 中 本 地 托管 。 

下 面 详 细 介 绍 各 个 选项 。 


1. 使 用 Azure App Service 


Azure App Service (AAS) 发 布 目 标 是 Visual Studio 2017 发 布 向 导 第 一 个 提供 的 
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选项 , 如 图 15-2 所 示 。 可 以 创建 新 的 App Service, 也 可 以 发 布 到 现 有 的 App Service。 

AAS 是 宿主 服务 ,可 以 托管 普通 的 Web 应 用 程序 、Web API( 如 REST APD 和 移 
动 后 端 。 它 不 仅 能 用 于 ASPNET 和 ASPNET Core， 而 且 支 持 Windows 和 Linux 上 
的 多 种 Web 环境 ， 如 Node.js、PHP 和 Java。AAS 提供 了 内 置 的 安全 性 、 负 载 平衡 、 
高 可 用 性 、SSL 证 书 、 应 用 程序 扩展 和 管理 。 此 外 , 可 以 将 AAS 与 GitHub 和 Visual 
Studio Team Services (VSTS) 的 连续 部 晋 结合 起 来 。 

AAS 按照 使 用 的 计算 机 资源 收费 ， 而 使 用 多 少 资 源 是 由 所 选择 的 App Service 
计划 决定 的 。AAS 还 与 Azure WebJobs 服务 集成 在 一 起 ， 为 Web 应 用 程序 添加 后 端 
作业 处 理 。 图 15-10 显示 了 Create App Service 页 面 ， 发 布 到 AAS 的 操作 就 从 这 个 
页 面 开始 (如 图 15-10 所 示 )。 


Create App Service a _ Publish 
Host your web and mabile pplcatlions, REST APIS, and rore Em Arure 
Publisth your spp a Anure tr Brviahiar hott. Leam mese 


加 ProgCor book - Wab Daploy 


Chehinag dhe Creatd buiion will cereais thse tollowlng Azary resoarcds 
Espherg od al em Aan servioes 


If on ha ve reammoved yanur sm enading limit or you are Usiray Pay as You G0, there may be monetary Impaxct HH you proviskon adhditional resmieves, 
[is 


图 15-10 ”创建 新 的 Azure App Service 


单 击 Publish 按钮 , Visual Studio 使 用 WebDeploy 把 所 有 必要 的 文件 上 传 到 AAS。 
几 分 钟 后 ， 应 用 程序 就 会 运行 。 图 15-11 显示 了 一 个 正在 运行 的 示例 应 用 程序 。 


和 司 问 ProgrammingAsPNET X 二 ww 


二 Cc) 1 Erogcore-bGook.arurewebstesnet 


0 SOURCE CODE 


-rogramming 四 
AS P N FT 1. Why Anothar [ASPY.NETY? 


。 2. The Flrat ASP.NET Core Project 
(GD |e 3. Bootsirapping ASP.NET MYC 
a. BSP.NET MY Contrallers 
5. ASP.NET MY Views 
. The hazor Syritax 
t. Dealgn Corelderatiore 
9. Securing your Application 
9. Access lo Applcation Data 
10. Designing a Weab BPI 
11. Posting Data from the Client Side 
la2. Clent-sidé Dala Binding 
13. Building Device-friendly Views 
14. The ASP.NET Core Runtime Envronmant 


15. Deploying an ASP.NET Core Applicsstion 
18. Mration arnd Adoption Sirategias 


图 15-11 示例 应 用 程序 正在 运行 
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发 布 了 应 用 程序 以 后 ，AAS 的 仪表 板 允 许 设置 应 用 程序 的 设置 条 目 ( 如 在 开发 
过 程 中 从 用 户 密码 获取 的 全 部 数据 ) 及 执行 必要 的 调整 。 

要 访问 应 用 程序 的 物理 文件 ， 尤 其 是 没有 预 编 详 的 Razor 视 岁 或 者 页 面 ， 可 以 
使 用 App Service Editor 服务 。 这 样 就 能 够 获得 对 已 部 普 文 件 的 读 / 写 访问 权限 ,甚至 
能 够 快速 进行 编辑 (如 图 15-12 所 示 )。 


过 https:/ progcore-bookscm.azurewebsites.net/dev i root Pages/Cower.cshtm 
A Appls) 7 Slots - Microsoft Azure .i 辣 Cover.cshtml - wwwroot - Ap..* | ”和 蜡 
霹 Blockchain™ BLnksw NNewsw BN Personal™ B Sodal™w % Bizw wRDICT (bgITLY |B Live sport streaming at bwi.. 


ExPLRE 
二 WORKING FILES 
Cewver.cshtml Pages 
3 WVUWROOT 


4 Pages 


div Elass=" CO0l-XS-12 CO0l-5m-8" 
忒 由 村 多 
< hretf="http: /Elthub 


站 
<i class="fa fa-github"></i>Bnbsp; 
SOURCE CODE 
fa 
/ha> 
ch1is.simplePage.dll l 
<h3s<brCHAPTERS* /br</h3> 
去 四 二 
chis.simplePage.runtimeconfig.son <lisWhy Another (ASP).NET?</1i; 
hostingstart.html lisThe First ASP.NET Core Project/l1i> 
liyBootstrapping ASP.NET MyC</1i> 
lisASP.NET MyE Contrellerse/]lis 
eli>ASP.NET MC Views</1i> 
li>yThe Razor Syntax</li> 


Ch1l5.SsimplePage.depsjson 


web,config 


B61lice RE 
| 


图 15-12 ”使 用 App Editor 服务 动态 编辑 Razor 文件 
2. 使 用 Service Fabric 


AAS 本 喘 提 供 了 大 量 功能 ， 如 目 动 扩展 、 喘 份 验证 、 限 制 调用 率 ， 以 及 方便 地 
集成 到 其 他 软件 服务 ， 如 Azure Active Directory、Application Insights 和 SQL。 对 于 
许多 团队 ， 特 别 是 网 站 管理 和 部 着 经 验 不 多 的 团队 ， 使 用 AAS 极其 简单 ， 是 理想 
的 选择 。 而 且 ，AAS 非常 适合 简洁 的 、 整 体式 的 和 几 平 无 状态 的 应 用 程序 。 那 么 ， 
如 果 Web 应 用 程序 是 更 大 的 分 布 式 系统 的 一 部 分 ， 情 况 如 何 呢 ? 

在 这 种 情况 下 ,很 可 能 会 使 用 微服 务 染 构 ， 其 中 一 部 分 市 点 适合 部 普 到 AAS 中 ， 
但 是 必须 能 够 与 其 他 节点 互 操作 。 使 用 Azure Service Fabric (ASF)， 更 容易 组 合 应 用 
程序 节点 。 假 想 这 样 的 场景 : 应 用 程序 需要 两 个 不 同 的 数据 存储 (关系 和 NoSQL)、 绥 
存 ， 可 能 还 需要 服务 总 线 。 如 果 没 有 ASF， 那 么 每 个 市 点 都 是 独立 的 ， 需 要 目 己 处 理 
容错 。 更 糟 的 是 ， 必 须 为 发 布 的 每 个 服务 处 理 容错 。 使 用 ASF 时 ， 绥 存 和 其 他 内 容 
将 与 主 应 用 程序 放 在 一 个 位 置 ， 提 高 了 访问 速度 ， 也 提升 了 可 和 菲 性 并 人 简化 了 部 著 。 

对 于 构成 一 个 池 的 多 机 系统 ，ASF 可 能 是 更 好 的 选择 。ASF 允许 从 简单 的 场景 
开始 ,但 是 很 容易 把 染 构 扩展 到 甚 衬 数 百 台 计 算 机 。 甚 至 可 以 混合 使 用 AAS 和 ASF， 
将 主 应 用 程序 部 普 为 AAS， 在 某 个 时 候 将 后 问 重 新 架构 为 ASF。 

表 15-2 列举 了 只 有 AAS 或 只 有 ASF 文 持 的 功能 。 该 表 中 没有 列 出 的 功能 在 两 
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种 场景 中 均 能 使 用 (或 均 不 能 使 用 )。 从 价格 的 角度 来 讲 ， 注 意 Service Fabric 本 号 不 
收费 。 收 忱 的 是 在 Service Fabric 上 局 用 的 实际 的 计算 资源 。 在 这 个 方面 ， 收 费 规则 
与 Azure 虚拟 机 相同 。 


表 15-2 AAS 和 ASF 的 能 力 


仅 Azure App Service 支持 仅 Azure Service Fabric 支持 
操作 系统 日 动 更 新 对 服务 器 进行 远程 果 面 访问 
将 运行 时 环境 从 32 位 切换 到 64 位 目 由 安 疤 目 定义 的 MSI 包 
通过 Git、FTP 和 WebDeploy 部 署 定义 自 定义 的 启动 任务 
Integrated Saas 可 用 : MySQL 和 监控 文 持 Windows 事件 跟踪 (Event Tracing for 
Windows，EIVW) 


要 部 署 到 Azure Service Fabric 中 ,必须 把 整个 应 用 程序 转换 为 Service Fabric 应 
用 程序 。 这 需要 安装 Service Fabric SDK， 并 使 用 Visual Studio 内 的 专用 应 用 程序 项 
目 目标 .关于 该 SDK 的 更 多 信息 ,可 访问 https://docs.microsoft.com/ en-us/azure/service- 
fabric/service-fabricget-started。 还 要 注意 ，Service Fabric 类 似 于 Cloud Services， 但 
是 Cloud Services 被 视 为 一 种 遗留 技术 ， 已 完全 被 Service Fabric 替代 。 


3. 使 用 Azure Virtual Machine 


Azure Virtual Machine (AVM) 介 于 AAS 和 ASF 之 间 。 如 果 需 要 的 不 只 是 一 个 整 
体式 应 用 程序 , 而 且 需 要 做 巨大 的 修改 才能 将 应 用 程序 发 布 到 ASF, 那么 选择 AVM 
是 明智 的 。 

顾名思义 ，AVM 是 一 个 交付 给 你 的 虚拟 服务 礁 ， 不 包含 任何 配置 和 设 将 ， 需 要 
由 目 己 配置 。AVM 在 核心 上 是 基础 结构 即 服 务 (Infrastructure-as-a-Service，IaaS)， 
而 ASF 和 AAS 都 是 平台 即 服务 (platform as a service)。 有 所 有 Azure 虚拟 机 都 提供 了 
免费 的 负载 平衡 和 目 动 扩展 能 力 。 在 Azure 中 创建 了 虚拟 机 以 后 ， 就 可 以 在 Visual 
Studio 中 直接 友 布 应 用 程序 。 

人 至 于 费用 ， 最 经 济 的 AVM 的 费用 为 每 月 10 美元 左右 ， 而 相对 较 好 的 AVM 的 
性 用 人 至 少 是 这 个 价格 的 10 倍 。 应 该 把 这 个 价格 计算 到 安装 软件 的 成 本 中 , 如 目 己 的 
SQL Server 许可 。 不 过 ， 总 的 来 说 ， 从 现 有 的 本 地 配置 迁移 到 Azure 时 ，AVM 是 最 
简单 方便 的 方法 。 
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目 关于 Microsoft Azure 各 种 托管 选项 的 更 多 细 凶 ,请 访问 https://docs.microsoft.com/ 


en-us/azure/app-service/choose-web-site-cloud-service-vm. 
4. 在 Visual Studio Code 中 部 署 应 用 程序 


如 前 所 述 ， 从 Visual Studio 目 动 部 普 到 Azure 几乎 是 立即 发 生 的 。 但 是 ， 如 
果 使 用 Visual Studio Code, 则 需要 一 些 额外 的 工具 。 特 别 是, 可 以 考虑 Visual Studio 
Marketplace 中 的 Azure Tools for Visual Studio Code( 参 见 https://marketplace.visualstudio. 


conyitemsylitemName=bradyspaster.azuretoolstorvscode)。 
15.2.3 部署 到 Linux 


由 于 ASPNET Core 具有 路 平台 本 质 , 因此 可 以 在 Linux 计算 机 上 托管 ASPNET 
Core 应 用 程序 。 第 用 的 方法 是 把 应 用 程序 文件 部 普 到 本 地 文件 严 ， 然 后 (通过 FTP 
或 其 他 方式 ) 将 其 镜像 上 传 到 服务 占 。 

对 于 Linnx， 有 两 种 主要 的 托管 场景 : 在 安 狼 了 Apache 的 计算 机 上 托 省 ;在 安 
闭 了 Neginx 的 计算 机 上 托 官 。 还 有 一 个 选项 是 使 用 Amazon Web Services 和 Elastic 
Beanstalk 工具 包 ( 参 风 https://aws.amazon.com/blogs/developer/aws-and-net-core-2-0)。 


1. 部 署 到 Apache 


将 ASPNET Core 应 用 程序 部 署 到 Apache 服务 器 的 一 个 实例 ， 意 味 看 需要 将 服 
务 器 环境 配置 为 反 向 代理 服务 器 。 第 14 章 介 绍 了 这 个 主题 ， 下 面 简 要 回顾 一 下 。 
要 将 Apache 用 作 反 加 代理， 在 /etchttpd/confd/ 目 录 中 需要 有 一 个 .conf 文件 。 
下 面 的 示例 内 容 告诉 Apache 使 用 端口 80 监听 所 有 卫 地 址 , 以 及 通过 指定 代理 计算 
机 收 到 的 所 有 请 求 。 在 本 例 中 ， 代 理 计算 机 为 127.0.0.1， 瘦 口 为 5000。 本 例假 定 
Apache 和 Kestrel 在 同一 计算 机 上 运行 ， 但 是 修改 ProxyPass 的 IP 地 址 ， 束 能 够 使 
用 不 同 的 计算 机 。 
<VirtualHost *:80> 
ProxyPreserveHost On 
ProxyPass / http://127.0.0.1:5000/ 


ProxyPassReverse / http://127.0.0.1:5000/ 
</VirtualHost> 


还 需要 一 个 服务 文件 ,用 来 告诉 Apache 如 何 处 理 对 其 托管 的 ASPNET Core 应 
用 程序 的 请 求 。 下 面 给 出 了 一 个 示例 服务 文件 。 


[Unitt] 
Description=Programming ASP.NET Core Demo 
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[Servicel 
WorkingDirectory=/var/progcore/chl5/simpleplage 
ExecStart=/usr/local/bin/dotnet /var/progcore/chl5/simpleplage.d1ll 
Restart=always 


# Restart service after 10 seconds in case of errors 
RestartSec=10 
SysloglIdentifier=progcore—chl5-simplepage 
User=apache 

Environment=ASPNETCORE ENVIRONMENT=Production 


[Installl 
WantedBy=multi—user.target 


须 从 命令 行 局 用 该 服务 。 如 果 上 述 服 务 文件 命名 为 progcore.service， 则 命令 
eat 


sudo nano /etc/systemd/system/progcore.service 


更 多 细节 请 访问 https://docs.microsoft.com/en-us/aspnet/core/publishing/apache-proxy。 
通过 查看 该 文档 ， 可 了 解 如 何 添加 SSL 和 防火 墙 设置 、 速 率 限制 、 监 视 和 负载 平衡 等 。 


2. 部 署 到 Nginx 


Nginx 是 一 个 开源 的 HITP 服务 器 ， 正 在 变 得 越 来 越 受 欢迎 ， 它 可 以 方便 地 用 
作 反 向 代理 和 IMAP/POP3 代理 服务 器 。 其 主要 特征 是 使 用 异步 架构 来 处 理 请 求 ， 
而 不 是 像 更 加 规范 的 Web 服务 器 (如 Apache) 或 更 老 版 本 的 IIS 那样 ， 使 用 更 加 传统 
的 基于 线程 的 染 构 。 因 此 ，Nginx 第 第 在 可 扩展 性 较 高 的 场景 中 作为 代理 ， 而 不 是 
用 在 高 流量 的 网 站 中 (参见 https:/www.nginx.com)。 

下 面 来 看 如 何 把 Nginx 配置 为 反 癌 代理， 以 托管 ASPNET Core 应 用 程序 。 
需要 修改 /etcmmginx/sites-available/default 文件 的 内 容 。 这 是 一 个 JSON 文件 ， 其 内 容 
与 下 面 类 似 。 

Server 1 

J]Jisten 80; 
location / { 
proxy pass http://localhost:5000; 
proxy http version 1.1; 


proxy set header Upgrade S$http upgrade; 
proxy set header Connection keep-alive; 
p 
Pp 


澡 


roxy Set header Host $host; 


roxy Cache bypass shttp upgrade; 

} 

如 果 Kestrel 服务 器 与 Nginx 不 在 同一 台 计 算 机 上 , 或 者 监听 的 端口 不 是 5000， 
则 可 以 通过 修改 proxy pass 属性 的 值 来 指定 Kestrel 服务 左 的 位 置 。 

与 Apache 一 样 ， 这 只 是 环境 完全 配置 的 第 一 步 。 将 请 求 转 友 给 Kestrel 束 足 够 
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了 ,不 需要 管理 Kestrel 及 其 .NET Core Web 答 主 的 生命 周期 。 需要 有 一 个 服务 文件 ， 
才能 启动 并 监视 底层 的 ASPNET Core 应 用 程序 。 创 建 这 个 服务 文件 的 方式 与 
Apache 相同 。 时 多 信息 请 访问 https://docs.microsoft.com/en-us/aspnet/core/publishing/ 


linuxproductton 。 


15.3 ”Docker 容器 


容器 是 一 个 相对 新 的 概念 ， 试 图 仿照 货运 行业 中 集装箱 的 概念 。 容 器 是 一 个 软 
件 单元 ， 包 含 应 用 程序 及 其 完整 的 依赖 和 配置 。 容 器 可 以 部 署 到 指定 的 宿主 操作 系 
统 ， 不 需要 做 任何 进一步 配置 就 能 够 运行 。 

对 于 开发 人 员 来 说 ， 容 器 代表 了 一 种 理想 的 场景 ， 所 有 代码 都 在 本 地 一 一 个 
神秘 的 “我 的 计算 机 ”， 在 这 里 所 有 代码 都 能 工作 一 一 运行 ， 也 能 在 生产 环境 中 运 
行 。 操 作 系统 是 确保 容器 在 部 署 后 能 够 工作 的 唯一 共同 点 。 


15.3.1 容器 与 虚拟 机 


初 看 上 去 ， 容 颖 与 虚拟 机 有 许多 相似 之 处 。 但 是 ,二 者 存在 一 个 根本 性 的 区 别 。 

虚拟 机 在 条 种 虚拟 化 的 偶 件 之 上 运行 ， 运 行 目 己 的 操作 系统 副本 。 为 外 ， 在 针 
对 东 种 场景 构建 虚拟 机 时 ， 虚 拟 机 必须 具有 对 这 种 场景 而 吝 必 要 的 所 有 二 进 制 文件 
和 应 用 程序 。 因 而 ， 虚 拟 机 可 能 有 几 GB， 需 要 儿 分 钟 才能 局 动 。 

容 骼 则 运行 在 指定 物理 计算 机 之 上 ， 使 用 该 计算 机 上 安 朔 的 操作 系统 。 换 人 苛 话 
说 ， 容 右 只 是 应 该 交付 箱 主 操作 系统 与 运行 应 用 程序 所 需要 的 环境 之 间 的 拳 寞 。 
此 ， 容 器 通常 只 有 几 MB， 只 需要 儿 秒 就 能 够 启动 。 

容 如 和 虚拟 机 最 终 部 将 应 用 程序 与 其 对 周围 环境 的 依赖 阳 离 ， 但 是 运行 在 同一 
侣 计算 机 上 的 多 个 容器 共 圣 答 主 操作 系统 (如 图 15-13 所 示 )。 


Docker 弓 | 警 


操作 系统 
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15.3.2 ”从 容器 到 微服 务 架 构 


多 个 应 用 程序 能 打包 到 一 起 ， 在 同一 虚拟 操作 系统 上 并 行 ， 这 个 市 来 了 一 种 新 

在 这 种 方法 中 ， 应 用 程序 及 其 配置 以 一 种 特殊 格式 (容器 镜像 ) 打 包 起 来 ， 部 署 
到 局 用 了 容 桌 的 服务 器 。 用 运 维 的 术语 讲 ， 这 还 意味 看 开发 环境 可 修 “ 快 照 ”"”， 转换 
成 能 够 在 指定 操作 系统 上 运行 的 一 段 独立 部 赣 的 代码 。 此 外 ， 容 器 镜像 可 以 轻松 从 
一 个 服务 贷 移 植 到 另 一 个 服务 器 ， 上 只 要 被 移动 到 一 个 鳞 容 的 、 司 用 了 容器 的 基础 结 
构 上 , 无 论 是 公有 云 还 是 私有 云 ， 其 至 是 本 地 的 物理 计算 机 ， 就 仍然 能 够 继续 运行 。 
容 右 化 的 口 写 就 是 “构建 一 次 ， 到 处 运行 ”。 

容 髓 化 将 整体 式 应 用 程序 分 解 成 为 独立 的 部 分 , 每 个 部 分 部 署 到 不 同 的 容 规 中 。 
可 以 把 一 个 SQL 数据 库 放 到 一 个 容器 ， 把 Web API 放 到 另 一 个 容器 ， 而 把 Redis 组 
存 再 放 到 一 个 容 堪 中 。 上 此外， 不同 的 容器 是 可 以 独立 部 灵 的 部 分 ， 可 在 将 来 进行 扩 - 
展 ， 或 者 轻松 地 更 新 /等 换 。 


15.3.3 Docker 与 Visual Studio 2017 


在 创建 项 目 时 选择 Enable Docker Support， 可 以 轻松 地 让 ASPNET Core 应 用 
程序 与 Docker 若 容 ， 如 图 15-14 所 示 。 选 中 该 复 选 枉 ， 项 目 中 会 上 月 动 添加 一 些 文 
本 文件 。 

New ASPNET Core Web Application -SimplepageDodeer 


.ET Core “ASP.NET Core 2.0 ~ | Learrn more 
An empty project template for creating an ASP.NET 


号 ] 号] LA Core application. This template does not have any 
content im it. 
Web APl Web Web Angular 
Application Application 
(Model-View- 
Controller) 


Learn more 


光 


React.js 


Authentication No Authentication 


Requl Windows . 


Dod 


图 15-14 为 ASPNET Core 应 用 程序 启用 Docker 支持 
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Dockerfile 是 其 中 最 重要 的 文件 ， 下 面 给 出 了 其 示例 内 容 。 


FROM microsoft/aspnetcore:2.0 

ARG Source 

WORKDIR /app 

EXPOSE 80 

COPY ${source:~obj/Docker/publish} . 

ENTRYPOINT ["dotnet", "ChlS.SimplePageDocker.dl1l1"™| 


项 目 还 会 在 一 个 狐 文 件 来 docker-compose 中 包含 其 他 几 个 文件 。 选 择 该 文件 夹 
时 ，Build 羔 单 会 改 为 显示 Docker 生成 选项 。 单 击 该 选项 将 创建 镜像 ， 并 将 其 部 署 
到 撒 层 局 用 了 容 回 的 服务 器 的 注册 表 。 要 在 Windows 计算 机 上 进行 本 地 测试 ， 需 要 
安装 Docker for Windows。 

创建 Docker 锐 像 后 ， 示 例 应 用 程序 会 从 一 个 不 常用 的 IP 地 址 运行 ， 通 党 是 
172.x.x.x( 如 图 15-15 所 示 )。 


浊 忆 172.18.9.17 


< 一 二 (〔() 从 172.18.9.17 
Hello Worldl! 
Microsoft Windows 10.0.14393 


图 15-15 运行 Docker 镜像 


在 obj/docker 文件 夹 中 可 查看 Docker 镜像 的 实际 文件 。 


15.4 ”小 纺 


本 章 探讨 了 将 ASPNET Core 应 用 程序 部 萤 到 生产 环境 的 各 种 选项 。 首 先 介 绍 
了 将 应 用 程序 文件 及 布 到 文件 夹 意味 看 什么 ， 以 及 如 何 处 理 ASPNET Core 的 跨 平 
全 本质。 在 此 过 程 中 ， 区 分 了 依赖 于 框 染 的 发 布 和 目 包含 的 应 用 程序 。 

接 下 来 , 详细 介绍 了 如 何在 Azure 中 托管 应 用 程序 ， 以 及 可 以 使 用 的 各 种 服务 ， 
包括 Service Fabric、 虚 拟 机 和 App Services。 最 后 ， 何 单 介绍 了 Docker 和 容 堆 。 

第 16 草 将 介绍 应 用 程序 的 迁移 ,brownfield 开 及 与 完全 重 与 应 用 程序 -ASPNET 
Core 旅程 将 在 第 16 章 结 束 。 
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了 迁移 和 及 用 末了 略 


犯错 是 建筑 过 程 中 最 费 钱 的 地 方 。 
四 。 偶 玉 六 特 寸 ， 《 壮 戌 春秋》 


ASPNET Core 并 不 是 ASPNET 4.x 的 最 新 版 本 。 虽 然 这 个 名 称 珊 有 ASPNET( 这 
是 有 意 为 之 ), 但 是 ASPNET Core 是 一 个 全 新 的 框架 , 只 是 受到 了 当前 的 ASPNET,， 
特别 是 ASPNET MVC 框架 的 深刻 启发 。 如 果 说 , 要 是 有 人 在 今天 重 写 ASPNET 会 
是 ASPNET Core 的 样子 , 不 算是 太 过 偏离 事实 。ASPNET Core 的 模块 化 程度 更 高 ， 
比 典型 ASPNET 占用 的 内 存 空间 更 小 ， 并 且 可 以 针对 多 个 人 硬件 /软件 平台 。 例 如 ， 
新 的 ASPNET Core 应 用 程序 现在 还 可 以 在 各 种 Linux 和 Mac OS 平台 上 原生 运行 。 

ASPNET Core 并 不 只 是 一 个 新 的 Web 框架 。 它 的 确 是 Web 框 染 ， 但 仍 需 要 一 
个 压 层 的 通用 框架 。 这 个 瓜 层 框架 是 .NET Core 框架 ， 是 它 提 供 了 跨 平 台 的 能 
全 于 对 开发 的 影响 ，ASPNET Core 与 .NET Core 是 结合 在 一 起 的 平台 ， 其 影响 力 相 
当 于 2002 年 发 布 的 ASPNET 和 .NET Framework。 幸 运 的 是 ， 新 平台 与 当前 平台 
间 的 差异 要 比 2002 年 时 小 得 多 。 

无 论 如 何 ,ASPNET Core 改变 了 在 Microsoft 堆栈 上 开发 Web 应 用 程序 的 方式 。 
因此 , 整个 团队 不 可 避免 地 要 更 新 一 些 技能 .除了 构建 应 用 程序 的 预算 , 为 ASPNET 
Core 平台 编写 应 用 程序 也 是 要 考虑 的 成 本 。 那 么 ， 如 果 你 是 公司 内 的 决策 制订 者 ， 如 
何 面 对 ASPNET Core? 如 果 你 是 提供 帮助 的 顾问 ， 如 何 让 对 方 接受 ASPNET Core? 

本 章 将 评 细 曾 述 新 框架 之 来 的 真实 好 处 。 


16.1 守 找 商业 价值 


导 说 ， 没 有 客户 愿意 付费 把 一 个 能 用 的 应 用 程序 换 成 吨 外 一 个 也 只 是 能 用 的 
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应 用 程序 。 男 一 方 惫 ， 软 件 并 不 是 死 的 ， 在 部 综 到 生产 环境 后 就 你 持 不 变 。 业 务 会 
改变 ， 所 以 理想 情况 下 ， 应 用 程序 应 该 随 独 业务 友 生 改变 ， 有 时 候 这 意味 看 彻 确 重 
写 应 用 程序 。 当 出 现 与 现 有 业务 有 巨大 关 别 的 新 业务 ， 或 者 出 现 了 有 吸引 力 的 新 技 
术 时 ， 可 以 重 写 应 用 程序 。 

ASPNET Core 不 会 创建 新 的 业务 机 遇 , 但 它 是 一 种 很 值得 关注 的 技术 ,问题 是 ， 
如 何 决定 它 有 多 值得 关注 , 能 够 之 来 多 大 的 好 处 ? ASPNET Core 并 不 能 增强 现 有 的 
应 用 程序 ， 使 之 应 对 新 的 业务 需求 。 但 是 ， 一 旦 出 现 了 新 的 业务 需求 ， 升 级 到 
ASPNET Core 是 一 个 值得 严肃 考虑 的 选项 。 


16.1.1 守 找 全 处 


总 的 来 说 ， 我 认为 对 ASPNET Core 所 做 的 鼓吹 在 很 多 地 方 没有 必要 。 在 我 看 
来 ， 这 完全 是 一 腔 热 忱 ， 却 没有 清晰 解释 转 而 使 用 ASPNET Core 给 业务 方面 市 来 
的 益处 。 但 是 ， 在 做 出 转 而 使 用 ASPNET Core 的 决定 时 ， 很 难 找 到 合理 的 理由 来 
放弃 相对 新 的 系统 ， 转 而 使 用 一 个 全 新 的 、 但 是 效果 与 之 前 的 系统 相同 的 系统 。 

一 个 被 一 再 强调 的 益处 是 ，ASPNET Core 使 代码 能 够 在 多 个 平台 上 运行 。 的 确 
如 此 ， 但 是 这 需要 重 写 所 有 的 代码 来 使 用 NET Core 框架 。 大 部 分 文献 还 强调 了 其 
他 好 处 ， 如 性 能 改进 、 代 码 模块 化 和 开源 代码 ， 以 及 一 些 非常 技术 化 的 方面 ， 如 全 
新 的 中 间 件 和 在 框架 中 大 量 使 用 了 依赖 注入 。 

我 不 会 说 这 些 不 是 益处 ， 但 是 它们 对 业务 的 真正 影响 取决 于 业务 本 身 。 如 果 响 
应 并 不 慢 ， 那 么 购买 更 快 的 应 用 程序 没什么 意义 。 当 业务 稳定 ， 并 不 指望 发 生 指数 
级 增长 时 ， 购 买 回 上 扩展 的 潜力 也 没什么 意义 。Microsoft 将 ASPNET 的 代 公 开源 ， 
对 于 将 大 部 分 开发 工作 外 包 出 去 的 公司 有 什么 价值 ? 类 似 的 例子 还 很 多 。 下 面 以 更 
加 批判 的 眼光 来 看 待 ASPNET Core 大 部 分 常 被 提 及 的 益处 。 


1. 多 平台 支持 


.NET Core 框架 是 对 .NET Framework 的 彻 展 重 写 ,专门 针对 在 包括 Windows 在 
内 的 多 个 不 同 平台 上 编译 而 创建 。 因 此 ， 针 对 .NET Core 框架 的 ASPNET Core 应 用 
程序 也 可 以 在 多 种 Linux 服务 器 平台 上 托管 。 准 确 来 说 ，.NET Core 框架 也 可 以 在 
Mac OS 上 运行 ， 但 是 对 于 托管 来 说 ， 这 一 点 目前 没有 影响 ， 因 为 没有 托管 平台 是 
基于 Mac OS 的 。 但 是 ， 让 .NET Core 框架 也 针对 Mac OS， 全 少 能 够 让 开发 人 员 可 
以 在 Mac 笔记 本 电脑 上 原生 编译 ASPNET Core 应 用 程序 。 

在 我 看 来 , ASPNET Core 应 用 程序 的 路 平台 本 质 是 其 最 重要 的 业务 价值 。 有 些 
人 可 能 认 为 ， 这 种 应 用 程序 仍然 是 Web 应 用 程序 ， 所 以 已 经 可 以 从 任何 平台 和 操作 
系统 上 访问 。 但是，ASPNET Core 应 用 程序 的 路 平台 本 质 的 真正 意义 在 于 托管 ， 而 
不 是 访问 。 很 多 公司 之 所 以 没有 考虑 ASPNET, 就 是 因为 运行 Windows Server 所 必 
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需 的 许可 ， 或 者 因为 他 们 只 能 使 用 Linux 这 样 的 开放 平台 (出 于 一 种 销 误 的 观念 ， 即 
采用 开放 平台 是 没有 费用 的 ， 一 些 政府 机 构 就 属于 这 种 情况 )。 而 且 ，Windows 托管 
仍然 比 Linux 托管 的 费用 高 ， 但 这 用 差别 不 大 ， 而 且 很 可 能 会 继续 缩小 。 这 如 使 
ASPNET Core 成 了 可 以 考虑 的 选项 。 最 后 ， 公 司 能 够 从 器 平台 的 ASPNET 受益 ， 
因为 (集成 ) 测 试 能 够 在 更 便宜 的 Linux 计算 机 上 运行 程序 ， 从 而 进一步 节省 成 本 。 
另外 ，Linux 的 托管 生态 系统 比 Windows 更 大 (参考 Mesos、Marathon 和 Aurora)， 
并 且 不 限制 只 使 用 一 个 供应 商 。 


2. 提高 性 能 


如 果 一 个 完全 重 写 的 框架 不 比 15 年 前 创建 的 框架 快 得 多 , 那 才 是 让 人 惊讶 的 事 
情 。 因 此 , ASPNET Core 一 定 比 经 典 ASPNET 更 快 .首先 看 看 为 什么 ASPNET Core 
更 快 ， 然 后 看 看 一 些 客 观 的 数字 。 

首先 ， ASPNET Core 的 管道 是 卉 步 的 ,保证 了 在 任何 时 候 上 只 有 最 少量 的 池 线 程 
是 繁忙 的 。 而 且 ， 管 道 经 过 重新 设计 ， 模 块 化 程度 极 高 。 最 后 ，Kestrel 分 发 请 求 的 
速度 极 快 。 另 外 , 在 ASPNET Core 中 , 每 个 请 求 占 用 的 内 存 是 在 ASPNET 中 的 1/5。 

关于 内 存 占 用 这 一 点 需要 进一步 讨论 。 第 14 章 介绍 过 ， 已 重新 设计 过 HTTP 运行 
时 管道 的 结构 。 在 ASPNET Core 出 现 之 前 ，ASPNET 应 用 程序 请 求 在 20 年 前 设计 的 
运行 时 中 处 理 ， 该 运行 时 是 为 ASPNET Web Forms 设计 的 。 老 管道 的 核心 是 名 声 不 佳 
的 system.web 程序 集 。 许多 人 认为 system.web 程 厅 集 是 经 典 ASPNET 应 用 程序 性 能 不 
佳 的 罪魁 祸首 , 但 是 我 只 在 一 定 程度 上 接受 这 种 观点 。system.web 程序 集 是 为 ASPNET 
Web Forms 定制 的 , 设计 得 非常 好 ,所 以 一 直 沿 用 了 二 十 儿 年 .Microsoft 引入 了 ASPNET 
MVC 时 , 选择 了 只 为 相同 运行 时 添加 必要 的 运行 时 扩展 。 由 于 这 个 设计 决策 , ASPNET 
MVC 并 没有 获得 其 应 有 的 定制 的 瘦 运 行 时 。 通 过 设计 ， 它 有 一 个 很 大 的 运行 时 ， 综 合 
了 两 种 截然 不 同 的 应 用 程序 模型 一 一 Web Forms 和 MVC 一 一 的 功能 。 

更 糟 的 是 , 在 引入 ASPNET MVC 几 年 后 , Microsoft 公司 发 布 了 Web API。Web 
API 是 从 头 设计 的 ， 有 自己 的 运行 时 来 处 理 请 求 ， 但 是 仍然 依赖 于 ASPNET 运行 时 
进行 托管 。 如 图 16-1 所 示 , 使 用 ASPENT MVC 和 Web API 的 应 用 程序 占用 的 内 存 
是 其 真正 需要 的 内 存 的 近 3 倍 ， 而 这 并 不 是 由 system.web 程序 集 导 致 的 。 


Web API 


system.web 


图 16-1 名声 不 佳 的 ASPNET 框架 组 合 
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ASPNET Core 中 性 能 提升 的 另外 一 个 原因 在 于 其 模块 化 。 整 个 ASPNET Core 
框架 以 NuGet 包 的 形式 提供 ， 人 允许 只 选择 目 己 真正 需要 的 功能 。 在 经 典 ASPNET 
中 ， 运 行 时 只 是 部 分 可 定制 的 ， 可 以 禁用 一 些 HTTP 模块 ， 但 是 整个 请 求 处 理 官 道 
基本 上 是 使 编 鸽 的。 如果 只 运行 ASPNET， 人 代码 有 机 会 比 在 ASPNET Core 中 更 先 
运行 。 

关于 提升 的 能 力 ， 有 数据 文 持 ， 可 以 但 看 https://github.com/aspnet/benchmarks 
有 友 布 的 基准 。 访 网址 给 出 的 数字 可 能 并 不 能 绝对 衡量 出 应 用 程序 运行 多 快 。 毕 竟 只 
是 基准 ， 对 于 真实 的 应 用 程序 ， 数 字 会 小 很 多 。 但 是 ，ASPNET 的 基准 和 ASPNET 
Core 的 基准 之 则 的 比率 很 可 能 是 相同 的 。 这 个 比率 说 明 ，ASPNET Core 在 单位 时 
间 内 处 理 的 请 求 数 是 ASPNET 的 5 倍 。 虽 然 如 此 ， 也 要 记 住 ， 就 处 理 的 实际 请 求 数 
而 言 ， 每 个 应 用 程序 都 是 不 同 的 。 

最 后 ， 关 于 性 能 ， 很 少 有 人 知道 应 用 程序 微调 的 实际 威力 。 笛 单 地 将 AddMvc 
符 换 为 AddMvcCore， 就 可 以 使 请 求 的 速度 几乎 加 倍 ， 人 至 少 对 于 处 理 的 初始 部 分 是 
如 此 。 有 一 个 实验 说 明 ， 通 过 使 用 core 配置 ， 用 ASPNET Core 处 理 100 万 个 请 求 
的 时 间 从 超过 2 秒 降低 到 1.2 秒 。 更 多 细节 请 访问 http://bit.ly/2wuvhD1。 


3. 改善 的 部 署 体 验 


ASPNET Core 在 宣传 时 , 将 经 典 ASPNET 支持 的 部 署 体验 定义 为 依赖 于 框架 。 
换 名 话说， 应 用 程序 在 交付 时 只 带 有 自己 的 二 进 制 文件 ， 这 意味 着 服务 器 上 应 该 已 
经 安 逆 了 了 必要 的 框 如 。 多 个 应 用 程序 可 以 共 孚 同一 框 如 ， 不 过 一 些 应 用 程序 可 能 需 
要 同一 框架 的 不 同 版 本 。 对 于 这 种 情况 ， 必 须 安装 框架 的 两 个 版 本 ， 而 这 可 能 导致 
一 些小 问题 ， 即 恶名 申 彩 的 “DLL 地 狱 ” 或 类 似 场 景 。 

ASPNET Core 提供 了 男 外 一 种 部 四 体验 ， 目 包 含 的 部 辕 。 在 目 包含 的 部 车 中 ， 
应 用 程序 在 交付 时 ， 不 只 包含 日 己 的 二 进 制 文件 ， 还 包含 整个 框架 。 应 用 程序 占据 
目 己 的 空间 ， 并 且 能 够 完全 独立 运行 ， 不 管 在 服务 左上 安 靖 了 什么 。 这 种 解决 方案 
确保 了 前 所 未 有 的 隔离 性 ， 但 是 代价 是 磁盘 空间 占用 量 增加 了 一 个 级 别 ， 通 常 从 几 
MB 增加 到 几 十 MB。 

如 第 15 草 所 述 , 可 以 在 多 种 Web 服务 器 上 托管 ASPNET Core 应 用 程序 , 最 主 
要 的 是 IIS 和 Linux 上 的 Apache。 但 是 ， 部 姥 时 并 不 是 仅 限 于 第 15 章 介 绍 的 选项 。 
还 可 以 在 一 个 完全 目 定 义 的 极 简 Web 服务 器 (可 能 是 某 个 开源 Web 服务 占 项 目的 分 
如 中 托管 ASPNET 应 用 程序 ， 尽 管 这 种 场景 并 不 常见 。 这 种 Web 服务 器 必须 实现 
IHttpRequestFeature 和 IHttpResponseFeature 接口 。 在 此 网 址 可 以 找到 一 个 起 点 : 
https://github.com/Bobris/Now1n. 


注意 : 
如 果 使 用 Windows, 并且 ASPNET Core 应 用 程 夺 针对 的 是 完整 的 .NET Framework， 
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那么 其 至 可 以 将 应 用 程序 作为 Windows 服务 托管 。 下 面 的 网 址 提供 了 一 个 示例 : 


https://docs.microsoft.com/en-us/aspnet/core/hostng/Wwindows-service. 
4. 改善 的 开发 体验 


ASPNET Core 的 编程 体验 非常 出 色 。 这 个 经 过 重新 设计 的 框架 非常 好 ,架构 也 
很 优秀 。 可 能 有 一 点 过 上 度 设 计 , 但 是 当前 所 有 的 ASPNET 最 佳 编程 实践 都 被 融合 了 
进来 。 公 少 在 儿 年 内 ， 很 难 找到 更 好 的 框架 。 

另外 ， 对 于 ASPNET Core 开发 ， 并 不 是 必须 使 用 Visual Studio 作为 开发 环境 。 
还 可 以 使 用 Visual Studio Code 开发 应 用 程序 , 与 Visual Studio 其 全 JetBrains 的 Rider 
相 比 , Visual Studio Code 是 免费 的 、 轻 量 级 的 。 而 且 像 Rider 一 样 , Visual Studio Code 
可 在 不 同 的 平台 上 使 用 。 

纯粹 从 编程 的 角度 看 ，Microsoft 公司 将 MVC 与 Web API 控制 器 模型 统一 了 起 
来 ， 并 添加 了 原生 的 依赖 注入 。 而 且 ， 中 间 件 的 模块 化 程度 极 高 ， 有 着 前 所 未 有 的 
机 会 只 编写 自己 需要 的 代码 ， 不 必 编 写 额 外 的 代码 行 。 


59. 开 闵 


在 网 址 https://github.com/aspnet 可 找到 ASPNET Core 的 完整 源 代 码 。 在 这 里 ， 
可 以 在 多 个 存储 库 中 导航 ， 找 到 构成 ASPNET Core 框架 的 各 个 包 、 文 档 和 示例 。 
数 百 位 Microsoft 贡献 者 和 社区 成 员 会 频 老 更 新 所 有 项 目 。 

开源 举措 是 一 项 有 力 的 声明 ， 表 明了 Microsoft 公司 对 发 展 ASPNET Core 的 决 
心 。 如 果 对 这 个 新 框架 还 有 疑问 , 想 一 下 在 2015 年 以 后 , 经典 ASPNET MVC 还 没 
有 新 的 版 本 。 当 然 ， 经 典 MVC 已 经 基本 完成 ， 没 有 太 多 可 添加 的 功能 了 ， 但 是 这 
仍然 可 以 说 明 , 整体 开发 精力 已 经 转 问 了 ASPNET Core。 因此, 接受 ASPNET Core 
最 终 只 是 个 时 间 问 题 。 在 短期 内 ， 还 需要 找 出 ASPNET Core 能 够 市 来 的 具体 业务 
价值 。 


6. 含 问 微服 务 架 构 


如 今 ， 微 服务 架构 颇 受 欢迎 ， 因 为 这 种 架构 很 好 地 结合 了 面 问 服务 架构 的 核心 
思想 ， 但 是 没有 SOA 原则 的 官僚 作风 。 本 质 上 ， 微 服务 是 可 独立 部 署 的 软件 应 用 
程序 ， 它 是 自治 的 ， 拥 有 清晰 定义 的 边界 。 可 以 使 用 任意 语言 和 任意 技术 来 编写 微 
服务 ， 因 为 它 是 独立 开发 和 部 署 的 ， 并 且 通 过 标准 通道 (可 能 是 HITP/MTCP、 消 息 队 
列 甚 全 共享 数据 库 或 文件 ) 通 信 。 

由 于 其 轻 量 本 质 、 速 度 和 灵活 性 ，ASPNET Core 非常 适合 用 来 实现 微服 务 。 而 
且 ， 从 微服 务 的 角度 看 ， 对 Docker 的 支持 使 ASPNET Core 更 加 值得 考虑 。 
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16.1.2 brownfield 开发 


现在 已 经 清楚 ， 采 用 ASPNET Core 并 不 是 将 正在 使 用 的 框架 或 产品 升级 到 下 
一 个 版 本 。 例 如 , 升级 到 ASPNET Core 不 同 于 从 SQL Server 2014 升级 到 SQL Server 
2016。 升 级 SQL 时 ， 所 有 的 表 、 视 图 和 过 程 仍 完全 可 用 ， 可 以 利用 已 经 升级 的 额外 
功能 (如 原生 JSON 和 版 本 表 )。 升 级 到 ASP.NET Core 却 没有 这 样 顺畅 的 过 渡 。 全 少 
需要 像 之 前 那样 付费 重 与 相同 的 系统 ， 更 不 必 说 寺 训 开发 人 员 一 一 任何 开发 人 员 
一 一 的 成 本 ， 以 及 后 续 的 、 可 能 是 临时 的 生产 效率 下 降 造 成 的 成 本 。 如 果 使 用 持续 
集成 (continuous integration，CJD)， 可 能 还 需要 考虑 针对 .NET Core CLI 工具 调整 CI 
管道 的 成 本 。 在 新 的 框架 上 有 了 与 之 前 相同 的 系统 ， 其 代价 取决 于 团队 成 员 的 技能 

很 容易 想到 的 一 点 是 ， 没 有 客户 会 愿意 付费 将 一 个 可 用 的 系统 奉 换 为 另 一 个 可 
用 的 系统 。 这 种 思想 引出 了 brownfield 开 肥 的 概念 。 

在 软件 中 ， 术 语 “brownfield 开发 ”是 指 这 样 一 种 场景 在 开发 新 系统 时 ， 仁 
细 考 虑 了 现 有 的 系统 。 换 句 话说 ，brownfield 开发 是 在 现 有 系统 和 技术 的 约束 下 ， 
开发 新 的 软件 。 在 brownfield 开发 场景 中 采用 搅局 式 框架 (如 ASPNET Core) 时 ， 需 

要 在 brownfield 场景 中 采用 ASPNET Core， 首 先 必 须 移动 到 分 布 式 架 构 中 ， 其 
中 系统 的 整体 行为 是 多 个 独立 组 件 ( 微 服务 ) 组 合 在 一 起 的 结 末 。 在 这 种 上 下 文中 ， 
可 以 认真 考虑 将 一 个 或 更 多 个 组 件 叔 换 为 使 用 了 一 种 新 的 、 甚 全 搅局 式 框 染 的 新 
组 件 。 总 之 ， 在 面 对 搅 局 式 框架 变化 时 ， 必 须 决 定 什么 是 壮 留 的 ， 什 么 人 不是， 并 
且 需 要 考虑 替换 非 遗 留 的 组 件 。 关 于 使 NET 架构 朝 着 微服 务 方向 演化 ， 参 阅 电子 
书 : https://aka.ms/microservicesebook。 

最 终 ， 使 用 ASPNET Core 是 可 以 进行 brownfield 开发 的 ， 但 是 成 本 往往 很 高 。 
如 何平 衡 完 全 在 于 其 交付 的 具体 业务 价值 , 而 这 只 能 在 具体 情况 中 具体 分 析 。 最 后 ， 
如 果 使 用 brownfield 开发 ， 那 么 必须 选择 什么 是 遗留 的 ， 什 么 不 是 ， 这 十 降低 技术 
债 的 一 步 。 


注意 : 
LE 为 仍 保留 在 ASPNET 空间 ， 注 意 组 件 供应 商 的 收入 大 部 分 仍然 来 自 ASPNET 
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Web Forms 产品 ， 因 为 公司 只 关注 自己 的 业务 ， 软 件 实际 上 是 作为 一 种 服务 。 只 . 
业务 场景 改变 (如 存在 扩展 性 问题 或 需要 抓 住 新 的 机 遇 ) 时 ， 公 司 才 会 认真 考虑 深度 
重 构 或 重 写 应 用 程序 。 可 扩展 性 是 最 被 滥用 的 术语 之 一 , 尤其 是 涉及 ASPNET 的 时 
候 。 我 并 不 认为 每 个 公司 都 有 可 扩展 性 问题 。 我 更 愿意 强调 ， 恨 好 的 代码 在 默认 情 
况 下 就 能 够 比较 好 地 扩展 。 因 此 ， 意 识 到 存在 可 扩展 性 问题 时 ， 很 可 能 是 因为 代码 
的 质量 不 高 。 


第 16 章 迁移 和 采用 策略 


16.1.3 greenfield 开发 


greenfield 开发 与 brownfield 开发 相反 ， 是 在 新 软件 系统 开发 不 受 任何 约束 时 产 
生 的 。 架 构 师 可 以 目 由 做 出 最 佳 决 策 ， 不 必 妥 协 。 在 这 种 情况 下 ， 决 定 是 否 采用 
ASPNET Core 就 完全 成 为 技术 问题 。 

稍 后 将 总 结 采 用 ASPNET Core 时 ASPNET 开 友 人 员 和 面临 的 技术 挑 成 。 这 个 总 
结 展示 了 ASPNET Core 与 ASPNET 框架 老 版 本 之 间 的 差异 ,但 没有 ASPNET 开发 
经 验 的 开发 人 员 可 能 对 这 个 总 结 不 感 兴趣 。 不 过 ， 在 总 结 之 前 ， 了 解 .NET Standard 
的 发 展 过 程 很 重要 。 


1. .NET Standard 规 泄 


.NET Standard 规范 试图 解决 在 同一 个 应 用 程序 的 多 个 版 本 一 一 移动 、Web 和 时 
而 一 一 之 间 .NET 代码 共享 的 问题 。 针 对 .NET Framework 指定 版 本 的 多 个 应 用 程序 
可 共享 相同 的 类 库 ， 并 且 不 保证 类 库 只 调用 框架 支持 的 函数 。 

NET Standard 为 命名 和 版 本 化 .NET Framework 的 特定 快照 提供 了 一 种 极 好 的 
方式 。 因 此 ， 每 个 NET Standard 版 本 都 定义 了 .NET 的 实现 必须 提供 的 API。 换 句 
话说 ， 一 旦 某 个 类 库 符 合 .NET Standard 的 某 个 版 本 ， 那 么 针对 与 该 NET Standard 版 
本 兼容 的 .NET Framework 版 本 的 任何 应 用 程序 ， 都 可 以 安全 地 使 用 这 个 类 库 。 

NET Standard 的 最 新 版 本 是 .NET Standard 2.0， 与 NET Core 2.0 结合 使 用 。 对 
于 涉及 ASPNET Core 的 新 的 greenfield 开发 , 这 应 该 是 最 低 需 求 。NET Standard 2.0 
包含 的 类 比 以 往 任 何 版 本 都 多 (甚至 还 重新 添加 了 ADO.NET 类 )。 根 据 Microsoft 公 
司 提供 的 数据 ，70% 以 上 的 NuGet 库 只 使 用 .NET Standard 2.0 的 API 部 分 。 

下 面 是 一 个 ASPNET Core 应 用 程序 的 CSPROJ 文件 的 框 染 签名 ， 这 个 应 用 程 
序 针对 的 是 ASPNET Core 2.0。 

<PropertyGroup> 


<TargetFramework>netcoreapp2.0</TargetFramework> 
</PropertyGroup> 


下 面 是 一 个 NET Standard 类 库 的 签名 。 


<PropertyGroup> 
<TargetFramework>netstandard?2.0</TargetFramework> 
</PropertyGroup> 


注意 ， 要 创建 一 个 .NET Standard 关 库 ， 需 要 在 Visual Studio 中 一 个 与 第 规 .NET 
Core 应 用 程序 不 同 的 厄 太 选择 指定 的 模板 (如 图 16-2 所 示 )。 
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dd New Project 


六 Recent -NET Framework 4.5 "| Sort by: = 和 search (Ctrl+E) 


到 Installed 乞 挤 Me E 
J 2 Class Library LNET Standardy Wis Type: Visual C# 
4 Wisual C# = A project for creating a class library that 
targets .NET Standard. 


Windows Classic Desktop 
Web 
.NET Core 
-MET Standard 
Cloud 
Extensibility 
Test 
WECF 
b Visual Basic 
Visual F# 
SL Server 
Al Tools 
br Javascript 
Powershell 
bt Typescript 


bb Online 


Not finding what you are looking for? 


人 Pen Wisual Studic Installer 


Name: ClassLibrary' 


Location: DAYwMy Demos\Core\TheBook\Programming ASP.,NET CorevSsrcv Browse... 


图 16-2 创建 /NET Standard 类 库 
2. ASP.NET 开发 人 员 面 对 的 磊 异 


在 ASPNET Core 中 ， 一 些 编程 任务 要 求 采 用 一 种 与 老 厂 本 ASPNET 不 同 的 方 
法 , 并 且 需 要 熟悉 一 套 新 的 API。 表 16-1 列 出 了 ASPNET Core 与 ASPNET 的 差异 。 


表 16-1 ASP.NET 中 有 不 同 的 编程 任务 
任务 描述 

局 动 应 用 程序 没有 global.asax 文件 ， 也 没有 web.config 文件 。 应 用 程序 的 初始 配置 
在 启动 文 件 中 进行 , 并 且 包 含 隐 藏 在 IS 和 ASP.NET 设置 中 的 任务 ( 设 
置 Web 笨 主 )。 应 用 程序 由 一 组 恰当 配置 的 服务 构成 。 此 外 ，ASP.NET 
Core 框架 引入 了 答 主 环境 的 概念 ， 这 是 一 个 对 象 ， 包 含 当 前 运行 时 环 
境 的 信息 

提供 静态 文件 ASPNET Core 应 用 程序 直接 提供 静态 文件 ,不 震 要 Web 服务 堆 的 协调 。 
必须 显 式 配置 这 种 行为 ， 但 是 配置 十 分 灵活 ， 人 允许 从 任何 路 径 和 数据 源 

传 圳 依赖 大 部 分 经 典 ASPNET 应 用 程序 使 用 自己 选择 的 IoC 提供 程序 来 传递 依 
赖 。ASP.NET Core 目 带 DI 子 系统 ， 不 能 禁用 这 个 DI 子 系统 ， 但 是 可 
以 把 它 蔡 换 为 草 容 的 IoC， 而 这 个 IoC 必须 已 经 移植 到 .NET Core， 并 且 
有 一 个 专门 的 连接 兹 来 连接 ASP.NET Core 的 DI 系统 
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( 续 表 ) 
任务 描述 
读 取 配置 数据 ASPNET Core 不 再 用 web.config 文件 来 包含 基本 的 应 用 程序 设置 。 配 


置 数据 显示 为 分 层 对 象 模 型 ， 由 各 种 数据 提供 程序 JSON、 文 本 文件 和 
数据 库 ) 填 充 。 配 置 数据 通过 DI 传递 


身份 验证 身份 验证 方案 现在 基于 声明 ， 而 不 再 严格 基于 cookie。 身 份 和 主体 等 概 
念 依然 存在 ， 但 是 API 不 同 ( 尽 管 在 概念 上 仍然 兼容 ) 
授权 授权 API 的 工作 方式 与 在 经 由 ASPNET 中 相同 ， 但 是 ASPNET Core 


提供 了 一 个 很 有 用 的 扩展 : 授权 采 略 。 应 该 认真 考虑 使 用 蛇 略 


可 以 看 到 ， 大 部 分 变化 都 在 控制 流 进入 控制 器 类 所 在 的 层 之 前 应 用 。 控 制 器 在 
很 大 程度 上 是 相同 的 ， 视 图 也 一 样 。 还 有 一 些 额外 的 功能 和 改进 ， 但 是 9996 的 控制 
器 和 视图 代码 通常 可 以 直接 用 在 ASPNET Core 中 ， 或 者 只 需要 做 很 少 的 修改 。 编 
程 技能 也 是 如 此 。 


3. 是 否 应 该 使 用 ASP.NET Core 


这 里 有 一 个 关键 的 问题 : 对 于 greenfield 开发 ，ASPNET Core 2.x 是 可 行 的 选 
项 吗 ? 

我 现在 的 答案 是 “是 的 "。 在 这 个 框架 早期 的 beta 测试 阶段 ， 我 焉 预测 过 ， 到 
2018 年 年 压 , 它 会 成 为 一 个 值得 认真 考虑 的 选项 。2015 年 年 压 的 一 个 漫不经心 的 预 
测 ， 如 今 似乎 已 经 被 业界 的 事实 和 情绪 所 证 实 ， 甚 至 超出 了 预期 。 不 考虑 ASPNET 
Core 的 爱好 者 和 过 销 人 员 的 说 样 ， 它 的 确 是 一 个 非 这 好 的 框架 ,但 是 对 于 现实 世界 
的 业务 和 物理 预算 ， 仅 这 样 还 是 不 够 的 。 

2018 年 ,我 期 待 ASPNET Core 这 个 基本 框架 ,更 重要 的 是 它 的 一 些 附属 框架 ， 
会 达到 一 种 更 好 的 成 熟 上 度 ， 特 别 是 Entity Framework Core 和 SignalR Core。 

对 于 数据 访问 ， 如 果 觉 得 最 新 的 EF Core 有 问题 ， 那 么 如 第 9 章 所 述 ， 还 有 其 
他 许多 选项 。micro O/RM 框架 是 一 种 很 好 的 符 代 方案 。 全 于 SignalR， 从 ASPNET 
Core 2.1 以 来 ， 它 就 是 这 个 家 族 的 官方 组 成 部 分 。 

还 缺少 什么 东西 吗 ? 在 Microsoft 方面 ， 我 希望 看 到 OData( 目 前 没有 将 来 会 文 
持 OData 的 流言 )， 我 还 希望 看 到 EF Core 能 够 文 持 系 统 版 本 的 表 ， 束 像 SQL Server 
2016 及 更 新 的 版 本 那样 。 但 是 ， 需 要 检查 自己 的 第 三 方 依赖 列表 ,确定 哪 些 现在 还 
不 符合 .NET Core， 进 而 可 能 影响 你 采用 ASPNET Core。 
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16.2 yellowfield 策略 概述 


假设 想 针 对 ASPNET Core 重 与 一 个 现 有 的 应 用 程序 。 场 景 是 这 样 的 : 业务 线 
应 用 程序 需要 刷 产 ， 可 能 还 需要 一 个 新 的 架构 。 换 句 话 说 ， 在 这 种 场景 中 ， 需 要 重 
写 同 一 个 业务 线 应 用 程序 ， 使 其 能 够 满足 相同 的 业务 需求 及 其 他 需求 。 

我 不 会 把 这 种 开发 分 类 为 纯粹 的 greenfield 开发 或 brownfield 开发 。 这 种 开发 介 
于 二 者 之 间 ， 可 以 称 为 yellowfield 开发 。 本 质 上 ， 这 是 开发 一 个 新 的 应 用 程序 ， 没 
有 架构 上 的 约束 ， 但 是 需要 遵守 一 个 非 功能 性 需求 : 保留 当前 生产 系统 中 尽 可 能 
的 代码 和 专业 技能 


16.2.1 ”处理 缺失 的 依赖 


开始 一 个 巨大 的 草 写 项 目 时 ， 染 构 文 柱 可 能 人 不同， 但 是 要 用 实际 代码 赴 充 。 可 
上 pra 省 开发 时 间 和 保留 已 经 做 出 的 投入 。 只 要 成 本 合适 ， 
这 么 做 是 合理 的 。 此 时 ， 可 能 过 到 下 和 而 的 情况 。 
e 要 使 用 的 一 些 NuGet pe dedieheer .NET Core。 
e 使 用 目 己 无 法 完全 控制 的 目 定 义 DLL， 并 且 这 些 DLL 在 .NET Core 中 不 
可 用 。 
e 代码 层 依赖 于 已 经 过 时 的 Microsoft 框架 , 包括 ASPNET Web Forms、Entity 
Framework 6、ASP.NET SignalR、OData 和 Windows Foundation Services。 
e 一 部 分 纯 C# 代 人 码 使 用 了 不 再 文 持 的 API 调用 。 
对 于 这 些 问 题 ， 有 有 岗 种 选择 : 重用 /调整 源 代 但 ， 或 者 在 相同 的 表面 行为 下 完全 
重 写 源 代码 。 在 本 章 剩 余部 分 , 将 介绍 两 种 可 选 的 各 略 来 重用 /调整 现 有 代码 。 不 过 ， 
自 先 要 做 的 是 分 析 现 有 的 代码 。 这 就 需要 用 到 .NET Portability Analyzer 工具 


16.2.2 .NET Portabllty Analyzer 


.NET Portability Analyzer 是 Visual Studio 的 扩展 , 可 从 Visual Studio 市 场 获 得 ( 参 
见 https://marketplace.visualstudio.com)。 这 个 工具 以 程序 集 的 名 称 (其 至 当前 解决 方 
案 的 完 束 情 全) 人 短信， 生成 Excel 文件 格式 的 报告 (如 图 16-3 所 示 )。 
告 让 你 能 够 了 解 使 代 但 在 .NET Core 中 成 功 运行 所 需要 的 工作 量 。 不 过 ， 谁 
全 来 说 ， 这 个 工具 并 不 只 用 于 .NET Core， 还 可 以 针对 多 种 目标 进行 配置 ,包括 .NET 
Framework 和 .NET Standard 规 泡 的 多 个 版 本 (如 图 16-4 所 示 )。 
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Hame LS Form ulas 


Te Calibri 
BIW+| 
chpboard 互 


Hs 


|submission | 十 
Description 
Targets 


hssemblhy 
Expoware,Dakota.Demo.server 
Expoware, Statis.scoreNanager2 


[9 


API Catalog last updated an 


EWrap Text General 


| Target Framework 
.NETFramework, Yersion=vd4.5 91.55 ED 
.NETFrameweork,Version=v4.5 | 
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ApiPortAnalysist3).xlsx - Excal Dino Esposito 


Rewieny VW ley Bdd-ins Tearr vi Tell me what veu wanit to do 


i CD | 夺 一 3 EE A 
re 
yy 对 Ex 加 司 . Z 于 Ed 


= Mernge & Center = $ -| 0 Conditional Formatas Caell Insert Delete Format 到 ot 各 Find 委 


:00 子 必 = 
Formatting™ Table™ Styles™ Filter = Select * 
Numbar 区 Styles 亡 @lls Editing 


B 
414c1868-f7ed-dd82-9a1b-9e66bce68f4e3 


.NET Core + Platform Extensions,.NET Core,.NET Framework Versionayd.5.2,.NET Frameweork Version=yd.7.1,.NET Standard 


国 .NET Core + Platform Extensions = | .NET Core .NET Standard 


Monday, Navember 27, 2017 


10 |see http://go.microsoft.com/ fvwlinky ?Linkld=397652' to learn how to read this table 


11 
12 


> We . 


Ready 


Options 


search Options (Ctrl+E) 


bb Environment 

k: Projects and Solutions 

k Source Control 

Work ltems 

>: Text Editor 

> Debugging 

kb Performance Tools 

4 .NET Portability Analyzer 
General 

tb Al Tools 

bt Container Tools 

bb Cross Platform 

bt Database Tools 

t: F# Tools 

File Nesting 

: NedeJjs Tools 

上 NuGet Package Manager 

bE Powershell Tools 

PP Productivity Power Tools 


有 些 情况 下 会 建议 如 何 修改 。 


General 
Default output directory Di\My Data 


Default output name ApiPortAnalysis 


Output formats 
[| json [LL]HIML Excel 
Target Platforms 
-NET Core 
_ 110 D11 M2.0 
.NET Core + Platform Extensions 
_ 110 [v2.0 


.NET Framework 


11 Cl20 Cl30 D35 Da0o Las Llas.1 [v4.5.2 
| 146 | 1a61 Lla62 La47 lw AT.1 


.NET Standard 
[10 D11 DODD12 D13 D14 D15 D16 M2.0 


Refresh re information is available at hitp: 


一 般 来 说 ，.NET Core 团队 遵循 两 条 关键 的 指导 原则 。 首 先 ， 只 包含 了 大 部 分 
开发 人 员 真 正 使 用 的 类 。 其 次 ， 对 于 每 个 必要 的 功能 ， 只 提供 了 一 种 实现 。 例 如 ， 
在 完整 的 .NET Framework 中 ， 全 少 有 3 个 不 同 的 类 可 发 出 HTTP 调用 : WebClient、 
HttpWebRequest 和 HttpClient。 只 有 Http Client 类 能 够 用 在 .NET Core 中 。 因 此 ， 如 果 
一 个 程序 集 使 用 了 WebClient， 分 析 咒 报告 的 百分比 就 会 降低 ， 不 过 修改 这 个 问题 十 
分 简单 。 一 般 来 说 ， 如 果 .NET Analyzer 报告 的 兼容 性 级 别 在 70% 以 上 ， 就 非常 好 了 。 
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注意 : 
.NET Portability Analyzer 也 可 以 作为 控制 台 应 用 程 夺 使用, 可 从 以 下 网 址 获得 : 
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https://github.com/Microsoft/dotnet-ap1port. 
16.2.3 Windows Compatibility Pack 


Windows Compatibility Pack (WCP) 是 一 个 NuGet 包 ， 提 供 了 对 .NET Core 2.0 中 
没有 包含 的 20 000 多 个 API 的 访问 。 这些 函数 中 人 至少 有 一 半 只 能 用 在 Windows 上 ， 
它们 用 于 加 密 、IO 端口 、 注 册 表 和 一 些 低级 诊断 等 领域 。 要 检查 代码 当前 是 否 
Windows 平台 上 运行 ， 并 且 调 用 是 合 安 全 ， 可 以 执行 下 面 的 操作 。 

1 (RUuNntimeInformation.IsOSPlatform(OSPlatform.Windows)) 

{ 

// Call some Windows-onlyYy function added with the WCP 

} 

另外 , WCP 中 还 包含 了 一 些 新 的 APL, 它们 有 路 平台 实现 ,但 还 没有 包含 到 .NET 
Core 2.0 中 。 在 这 个 列表 中 ， 可 以 找到 System.Drawing、CodeDom API 和 内 存 绥 存 。 


16.2.4 推迟 跨 平 台 挑 战 


运行 可 移植 性 分 析 工 具 ， 可 以 衡量 移植 的 工作 量 ， 或 者 至 少 用 来 大 致 估计 移植 
所 需要 的 工作 量 。 但 是 ， 分 析 器 的 结果 上 只 对 直接 控 制 的 代码 组 件 有 意义 。 如 果 现 有 
应 用 程序 依赖 于 外 部 依赖 ， 那 么 在 源 代码 级 别 做 不 了 什么 。 第 见 的 情形 包括 依赖 于 
第 三 方 的 NuGet 包 或 普通 的 类 库 DLL， 或 者 依赖 于 由 于 某 种 原因 不 能 在 .NET Core 
中 和 直接 使 用 的 Microsoft 框架 。 表 16-2 列 出 了 目前 在 NET Core 中 不 可 用 的 ， 或 者 至 
少 其 原始 形式 不 可 用 的 ， 最 第 见 和 最 流行 的 .NET 框 染 。 


表 16-2 .NET Core 中 不 直接 支持 的 流行 Microsoft 框架 


框架 前 沿 
Entity Framework 6X 和 喝 早 版 本 被 Entity Framework Core 2.0 和 更 新 版 本 取代 
ASPNET SignalR. 被 ASPNET SignalR Core 取代 
用 于 Web API 的 OData 扩展 无 计划 
Windows Communication ASPNET Core 应 用 程序 可 通过 一 个 额外 的 、 专 门 的 客户 问 
Foundation 库 (https:/Wsgithub.comy/dotnet'wcf) 使 用 现 有 的 WCE 服务 ， 但 


是 不 文 持 公开 WCF 服务 。 目 前 这 种 扩展 正在 观察 中 
Windows Workilow Foundation 无 计划 
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如 果 维 护 其 中 某 些 框架 或 库 的 依赖 至 关 重 要 ， 那 么 只 有 两 种 选择 。 一 种 是 在 对 
当前 使 用 的 非 .NET Core 平台 所 做 工作 的 基础 上 再 接 再 万 。 另 一 种 是 将 前 端 移动 到 
ASPNET Core， 但 是 推迟 路 平台 挑战 (如 图 16-5 所 示 )。 


New ASP NET Core Web Application - WebApplication1 


“| ASPNET Core 2.0 “| Laarn more 


An empty Project template for creating an ASP.NET 


| 时 | 四 Core application. This template does not have any 


Eee content in it. 
Web API Web Web Angular 
Application Application 
[hadel-Vioww- 
Controller) 


Learn more 


React.js React,js and 
Redux 


Authentication No Authentication 


L_| Enable Docker Support 


DOs: Windows 
Requires Docker for Windows 


Docker support can also be enabled later Learn more 


图 16-5 选择 目标 NET Framework 


创建 ASPNET Core 项 目 时 , 可 以 选择 针对 .NET Core 框架 或 完整 的 NET Framework。 
如 果 选 择 针 对 完整 的 NET Framework， 则 将 完整 保留 现 有 代 公 ， 全 少 是 处 理 依赖 的 


web.config， 以 及 其 他 经 典 ASPNET 实践 。 

如 果 针 对 .NET Core 框架 ， 则 ASPNET Core 可 以 释放 其 真正 的 威力 。 一 般 建 议 
只 有 必要 的 时 候 ， 才 针对 完整 的 .NET Framework。 夯 一 方面 ， 如 果 有 必要 针对 完整 
的 .NET Framework, 很 可 能 不 把 代码 移植 到 ASPNET Core, 也 能 继续 使 用 应 用 程序 。 


16.2.5 ” 走 回 位 服务 架构 


为 了 保留 现 有 的 关键 代码 ， 可 以 以 完整 的 .NET Framework 为 目标 ， 也 可 以 维护 
结果 应 用 程序 中 的 整体 式 结构 。 下 和 而 深入 探讨 一 种 非常 具体 的 场景 : 保留 对 EF6 类 
据 访 问 代 人 码 付出 的 投入 。 


1. EF6 和 限界 上 下 文 


Entity Framework Core 和 Entity Framework 6 看 上 去 非常 相似 , 但 是 两 者 在 的 层 
有 看 巨大 的 区 别 。 最 重要 的 一 点 是 ， 不 管 怎样 ， 不 需要 重新 尝 习 所 有 技能 ， 因 为 这 
两 个 框架 的 目标 是 相同 的 。 从 我 个 人 来 讲 , 因为 只 使 用 EF6 中 非常 有 限 的 一 些 函 数 ， 


373 


第 V 部 分 ASPNET Core 生态 系统 


所 以 每 次 把 EF6 代码 放 到 EF Core 项 目 中 时 ， 只 需要 做 极 小 的 调整 ， 代 码 很 快 束 能 
够 工作 。 但 是 ， 我 指 的 是 Code First 代码 ， 没 有 延 到 加载 、 没 分 组 、 没 有 基 架 和 迁 
移 ， 也 没有 事务 ， 只 有 普通 的 租 询 和 更 新 。 

EF Core 正在 稳步 发 展 ， 但 这 是 一 个 庞大 的 重 写 项 目 ， 你 在 自己 的 职业 生涯 中 
可 能 也 已 体会 到 ， 任 何 庞大 的 重 与 项 目 都 需要 大 量 时 间 。 到 了 EF Core 2.0， 开 发 团 
队 仍然 不 建议 将 EF6 应 用 程序 移 到 EF Core， 除 非 有 非常 合理 的 原因 。 建 议 使 用 EF 
Core 从 头 重 与 数据 访问 层 ， 每 当 遇 到 一 个 不 存在 或 者 工作 方式 不 同 的 功能 时 ， 吏 寻 
找 蔡 代 方 法 。 可 以 在 以 下 网 址 阅读 EF Core 最 新 的 路 线 图 : http://github.com/aspnet/ 
EntityFrameworkCore/wiki/Roadmap。 特 别 建 议 阅 读 Backlog 部 分 的 Critical O/RM 
features 小 六 。 

把 应 用 程序 移植 到 ASPNET Core 时 ， 如 何 处 理 重 要 的 EF6 数据 访问 层 ? 限界 
上 下 文 在 这 种 情况 下 很 有 用 。 图 16-6 显示 了 第 一 种 方法 。 将 应 用 程序 作为 一 个 整体 
保留 ， 推 迟 路 平 侣 挑战， 选择 完整 的 NET Framework 作为 目标 。 


ASPNET Core 应 用 程 厅 


NET Framework 


EF6 层 


图 16-6 移动 到 ASPNET Core， 但 目标 是 NET Framework， 以 保存 EF6 代码 


还 可 能 想 把 EF6 数据 访问 层 隔离 到 一 个 独立 的 API， 使 其 脱离 主 应 用 程序 ， 这 
样 可 以 为 ASPNET Core 和 .NET Core 框架 开 友 主 应 用 程序 。 在 此 过 程 中 ,还 可 以 使 
用 EF Core 和 EF6 代码 划分 数据 访问 层 的 功能 (如 图 16-7 所 示 )。 


ASPNET Core 应 用 程序 


.NET Core Framework Te 
数据 访问 Web API 


0 NET Framework 
EF6 层 


图 16-7 将 主 应 用 程序 的 上 下 文 和 EF6 的 上 下 文 分 隔 开 
可 以 随 总 使 用 这 种 模式 。 它 最 终 形成 了 一 个 微服 务 染 构 ， 并 且 能 在 容 右 的 术语 
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中 找到 其 对 应 的 术语 。 
2. 关于 容器 


把 应 用 程序 分 割 为 更 小 的 部 分 时 ， 束 开始 有 了 一 个 做 服 务 架 构 。 如 果 业 寞 能 够 
瓯 术语 “微服 务 ” 的 定义 达成 一 致 ， 不 会 与 下 面 的 定义 有 太 多 偶 关 : 微服 务 是 一 个 
可 独立 部 硝 的 应 用 程序 ， 以 目 治 的 方式 运行 ， 并 使 用 目 己 的 技术 、 语 言 和 基础 结构 。 
独立 部 羞 的 含义 是 ， 部 羞 微 服务 不 会 影 啊 应 用 程序 的 其 余部 分 。 可 采用 多 种 方式 部 
署 做 服务 ， 包 括 使 用 容 占 。 

如 今 ， 容 器 通 沼 用 在 微服 务 架 构 中 。 一 般 来 说 ， 可 以 使 任何 Web 应 用 程序 或 
Web API 容 费 化 ， 无 论 它们 及 用 了 什么 染 构 和 技术 。 在 容 右 的 眼中 ， 所 有 拉 术 都 是 
平等 的 ， 但 是 不 可 避免 的 是 ， 一 些 技术 比 其 他 技术 更 加 “平等 ” 例如 ， 可 以 容 右 化 
任何 .NET Framework 应 用 程序 , 但 这 只 能 在 Windows 容器 中 进行 。 与 之 相反 , .NET 
Core 应 用 程序 可 以 在 Windows 和 Linux 上 容器 化 。 此 外 ，.NET Core 容器 镜像 比 
韭 .NET Core 应 用 程序 的 容器 镜像 小 得 多 。 最 后 ， 因 为 .NET Core 应 用 程序 是 路 平台 
的 ， 所 以 可 以 把 镜像 放 到 Linux 容器 中 ， 也 可 以 放 到 Windows 容器 中 。 


16.3 ”小结 


不 能 因为 ASPNET Core 是 熟悉 的 ASPNET 框架 的 新 版 本 ， 就 使 用 ASPNET 
Core。 相 反 ， 应 该 调查 ASPNET Core 是 否 能 够 提供 业务 价值 。ASPNET Core 的 主 
要 价值 在 于 其 路 平台 本 质 , 这 人 允许 公司 在 更 便宜 的 Linux 服务 器 上 托管 应 用 程序 (用 
于 生产 或 测试 )， 从 而 节省 成 本 。 另 外 一 个 要 考虑 的 因素 是 ，ASPNET Core 的 运行 
时 性 能 更 好 ， 并 且 ASPNET Core 框架 高 度 模块 化 ， 使 其 非常 适合 用 于 可 扩展 程度 
高 的 应 用 程序 。 

虽然 如 此 ， 如 果 当 前 没有 遇 到 性 能 问题 ， 并 且 近 期 不 会 大 量 扩展 或 修改 架构 ， 
则 不 宜 仅仅 为 了 移植 而 移植 。 
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